Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create project documentation #2

Open
mit3r opened this issue Dec 14, 2024 · 2 comments
Open

Create project documentation #2

mit3r opened this issue Dec 14, 2024 · 2 comments

Comments

@mit3r
Copy link
Collaborator

mit3r commented Dec 14, 2024

Create documentation

We should create documentation for our project. Some mechanisms are quite complicated and difficult to understand just by looking at a code snippet, and a simple description in such documentation will allow us to properly direct our project.

Requirements

Documentation should convey the general principle of how the code works. It will be a single Markdown file (.md), in which individual sections will explain mechanisms, e.g. choosing a seat, what happens in the lobby

@mit3r mit3r self-assigned this Dec 14, 2024
@mit3r mit3r removed their assignment Dec 29, 2024
@mit3r mit3r changed the title Create README Create project documentation Jan 11, 2025
@Aleks334
Copy link
Member

Maybe we could also use JSDoc (with better-docs) in project and auto-generate api docs? An .md file might still be useful to provide more details. It can be done also later if it isn't needed now.

Example of docs made with jsDoc & better-docs: https://softwarebrothers.github.io/example-design-system/index.html

https://jsdoc.app/
https://github.com/SoftwareBrothers/better-docs

@mit3r
Copy link
Collaborator Author

mit3r commented Jan 11, 2025

It looks very nice. For now we can collect documentation in this one file, but in the future if it will be more handy we will think about these solutions

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

When branches are created from issues, their pull requests are automatically linked.

2 participants