8000 Documentation requeset · Issue #92 · argtable/argtable3 · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Documentation requeset #92

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
lonble opened this issue Mar 2, 2024 · 3 comments
Open

Documentation requeset #92

lonble opened this issue Mar 2, 2024 · 3 comments
Assignees

Comments

@lonble
Copy link
lonble commented Mar 2, 2024

Do you have plans to provide complete documentation? The content in https://www.argtable.org/tutorial/ seems out of date, and a large number of APIs lack descriptions.

I had to read the source code to understand what advanced features this library provides, but it's over six thousand lines of code, which is a little frustrating.

@lonble lonble changed the title Document requeset Documentation requeset Mar 2, 2024
@tomghuang tomghuang self-assigned this Mar 3, 2024
@tomghuang
Copy link
Contributor

@lonble : Yes, I do have plans to update the current documentation. Thanks for reminding me and I'll push the patch in a few weeks. Before releasing the new documentation, you can check the examples. If you want to see some common examples, please also let me know, since I also plan to expand the sample applications.

@alanmimms
Copy link

There is a docs directory that has numerous references to doxygen generated documentation, but there is no link to a web site with that documentation? Is this intentional? Should we just generate our own with doxygen rather than relying on you doing so when you make a release?

814B

@tomghuang
Copy link
Contributor

Hi @alanmimms , thanks for reminding me this issue.

My original plan is using the Sphinx-based toolchain to generate the documentation from the Doxygen comments in the code base, and then copy the generated documentation to argtable.org, so that the website can always be up-to-date. However, I haven't finish this plan yet.

I plan to make a release in June. If I cannot finish the documentation at that time, I'll temporarily remove the docs directory and create a new release anyway.

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

No branches or pull requests

3 participants
0