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

Document models #34

Open
PromiseFru opened this issue Mar 14, 2022 · 3 comments
Open

Document models #34

PromiseFru opened this issue Mar 14, 2022 · 3 comments
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers

Comments

@PromiseFru
Copy link
Member

A model is a single unit (functions) that performs a particular operation. Models are found in the /models directory in the repository. Due to the increase in features of the project more models are created and it'll be good to be able to know which model can perform a particular operation to avoid creating duplicate models

Preferred tool: https://www.npmjs.com/package/jsdoc
Preferred export format: Markdown https://github.com/jsdoc2md/jsdoc-to-markdown

@PromiseFru PromiseFru added documentation Improvements or additions to documentation good first issue Good for newcomers labels Mar 14, 2022
@moforemmanuel
Copy link

Good morning @PromiseFru
Exporting with jsdoc2md emits just skeletal markdown, no styles, scripts, custom fonts included (suppose using a jsdoc template like docdash).
Will it be sufficient enough to fit the requirements?

Looked for alternatives, and Pandoc seemed worth a try but little complicated a process, so I thought of reaching out ...

@PromiseFru
Copy link
Member Author

Good morning @PromiseFru Exporting with jsdoc2md emits just skeletal markdown, no styles, scripts, custom fonts included (suppose using a jsdoc template like docdash). Will it be sufficient enough to fit the requirements?

Looked for alternatives, and Pandoc seemed worth a try but little complicated a process, so I thought of reaching out ...

Hi @moforemmanuel, that sounds great! Please feel free to proceed with your implementation 🙂

@moforemmanuel
Copy link

moforemmanuel commented Apr 19, 2023

Alright.
Also, should it be a standalone project (own repo) or a sub project (folder) of SWOB-BE?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers
Projects
None yet
Development

No branches or pull requests

2 participants