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

[Feature Request] Add documentation site #113

Open
filzrev opened this issue Feb 19, 2024 · 2 comments
Open

[Feature Request] Add documentation site #113

filzrev opened this issue Feb 19, 2024 · 2 comments

Comments

@filzrev
Copy link

filzrev commented Feb 19, 2024

Are there any plans to add a documentation page?

It seems some Cysharp organization repositories have docfx-based documentation.
And published to GitHub Pages.

List of Cysharp's published sites

UniTask https://cysharp.github.io/UniTask/
MagicOnion https://cysharp.github.io/MagicOnion/

I’ve tried to create docfx-based site generation on cloned repository.
And it seems to work almost well.

Demo site

Note

Cysharp's docfx-based sites are using DocfxTemplate (https://github.com/Cysharp/DocfxTemplate)
But it's not compatible with latest version of docfx template (modern template)
So it may needs to adjust styles.

**Required steps to enable GitHub Actions based pages deployment **

  1. Enable GitHub Actions based Pages deployment
    from following setting page.
    https://github.com/Cysharp/R3/settings/pages
  2. Change settings atAbout on right navigation.
    And enable Use your GitHub Pages website setting.
@neuecc
Copy link
Member

neuecc commented Feb 20, 2024

Thank you, I will consider it (after modifying DocfxTemplate).

@egil
Copy link

egil commented Apr 16, 2024

Instead of documentation on a website, I strongly prefer just having codedocs added. That way the documentation is available right in the code/editor.

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