Skip to content
New issue

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

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

Already on GitHub? # to your account

Should documents be hosted in a repository instead of a wiki, so that everyone can easily write contributing documents? #546

Open
2 tasks done
ajiho opened this issue Jul 14, 2024 · 3 comments

Comments

@ajiho
Copy link

ajiho commented Jul 14, 2024

Is your feature request related to a problem?

Describe the solution you'd like

I want to use some open-source documentation tools to rewrite the document. Vitepress is a great choice in theory, but this is a PHP project and I personally haven't introduced node and npm technology stacks to implement the document. Therefore, there is another good option, it doesn't need to be built locally, just preview it directly

The specific reference address is: https://docsify.js.org/#/

Additional context (optional)

@jrfnl
Copy link
Member

jrfnl commented Jul 14, 2024

That's 100% the idea for the future, but not the highest priority at this moment.

If and when this will happen, it will be a GH Pages based website using Jekyll, maintained in a separate repo. The docs themselves would be in markdown, so would be straight forward for people to contribute to. So no need for another tool set.

Also see related discussions in #317

If you have any suggestions for now to improve the wiki docs, please feel free to share them here and I'd be happy to update the wiki with good suggestions.

@jrfnl
Copy link
Member

jrfnl commented Jul 14, 2024

P.S.: if you want to volunteer to take on the sub-project of getting a first version of that website up and running, I'll happily take you up on it ;-)

@ajiho
Copy link
Author

ajiho commented Jul 17, 2024

#317 I have reviewed the relevant discussions and gained some information . don't worry, these document tools basically only require contributors to write markdown format files. As you said, you can create a separate docs repository under the organization to host documents, but my native language is not English. What I can do is try to copy the documents from the original wiki and provide a translated Chinese version

# for free to join this conversation on GitHub. Already have an account? # to comment
Projects
None yet
Development

No branches or pull requests

2 participants