Skip to content

[FEATURE] Documentation extraction from package #13

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

Open
nandagopalan opened this issue Sep 24, 2024 · 4 comments
Open

[FEATURE] Documentation extraction from package #13

nandagopalan opened this issue Sep 24, 2024 · 4 comments
Assignees
Labels
enhancement New feature or request

Comments

@nandagopalan
Copy link
Contributor

Create a script that extracts package readme from https://github.com/nandlabs/golly. This needs to happen for every release.

We also need to maintain the golly docs link for old releases.

@nandagopalan nandagopalan added the enhancement New feature or request label Sep 24, 2024
@nandagopalan nandagopalan self-assigned this Sep 24, 2024
@nandagopalan
Copy link
Contributor Author

nandagopalan commented Sep 24, 2024

@neo7337 am thinking that we need to have a place holder in package to indicate that the readme of this package can be extracted to create documentation. Something like empty file named .use-doc

any suggestions ?

@neo7337
Copy link
Collaborator

neo7337 commented Sep 25, 2024

Each package would contain a README.md file, we can traverse and parse the documentation based on that and we will also know which documentation belongs to which package. Won't this work?🤔 @nandagopalan

@nandagopalan
Copy link
Contributor Author

nandagopalan commented Sep 25, 2024

Well some packages you may want to have the Readme.md for technical information but don't want it to be documented isn't it?

The proposal is to have a file/marker to indicate that this README should go as doco website

@neo7337
Copy link
Collaborator

neo7337 commented Sep 25, 2024

I guess for that purpose we can create a marker file.

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

No branches or pull requests

2 participants