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

Gradle Community Repository and Subsite #1

Open
oleg-nenashev opened this issue Feb 15, 2024 · 2 comments
Open

Gradle Community Repository and Subsite #1

oleg-nenashev opened this issue Feb 15, 2024 · 2 comments
Assignees
Labels
documentation Improvements or additions to documentation website Community wedsite

Comments

@oleg-nenashev
Copy link
Member

We need a repository for random community stuff that does not need versioning along with Gradle releases and hence not a part of docs.gradle.org. I will build it as an open source MkDocs Multi-Repo site (with mainly Markdown), with listing for events, like GSoC contributor guidelines, and other content we have or want to add.

The website will be likely published as GitHub Pages or on community.gradle.org

@oleg-nenashev oleg-nenashev self-assigned this Feb 15, 2024
@oleg-nenashev oleg-nenashev added website Community wedsite documentation Improvements or additions to documentation labels Feb 20, 2024
@martinbonnin
Copy link

I like MkDocs but out of curiosity, any reason to choose markdown when most Gradle docs are already AsciiDoc?

@oleg-nenashev
Copy link
Member Author

@martinbonnin We do not choose Markdown only. We want to have support for Asciidoc, at least to some extent. We do not leverage complex Asciidoc features in docs.gradle.org, so the conversion is relatively straightforward.

On the other hand, we want to include existing repositories, and README.md and Markdown sub-sites (vanilla GitHub flavored Markdown, Jekyll & Co) are dominant across the Gradle ecosystem

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 website Community wedsite
Projects
Status: Preview / In review
Development

No branches or pull requests

2 participants