CONTRIBUTING.md

ttth

Contributing

general

When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.

jsdoc

The current jsdoc documentation can be found on https://yafp.github.io/ttth/. It is auto-generated (using JsDoc Action) on each commit of this project.

Building ttth

Building ttth yourself is pretty easy. Please see the building instructions for more details.

Sentry (Crashreports)

Crashreport informations are located here.

Getting started

1. First steps

Clone repo

• Clone the repository: git clone https://github.com/yafp/ttth

Install dependencies

• Go into the repository: cd ttth
• Install dependencies: npm install

Run the code

• Execute: npm start

Run the code with debug logging

• Execute npm run start-debug

Run the code with verbose output

• Execute: npm start-verbose

Run some basic test

• Execute: npm test

2. Adding functions

adding a new service

• Edit app/js/ttth/services.json and add the new service
• Check the function loadServiceSpecificCode in /app/js/ttth/renderer.js

other modification or changes

• ....

3. Misc howto's

Auditing

npm auditing (scan for vulnerabilities)

• npm audit

Install packages

install single package

• npm install PACKAGENAME --save

npm: install single package in specific version

• npm install PACKAGENAME@1.2.3

Outdated packages

check for outdated npm packages

• npm outdated

or using npm-check:

• Install requirements: npm install -g npm-check
• Run check: npm-check

Updating

check dependencies

• Install requirements: npm install depcheck
• Run check: depcheck

update single package

• npm install PACKAGENAME --save

update all packages

• npm update

Others

List all package.json scripts

• npm run

or a dynamic solution

• Install requirements: npm i -g ntl
• Execute ntl