Skip to content
This repository has been archived by the owner on Jul 24, 2024. It is now read-only.

Switch to Jekyll #112

Closed
kahboom opened this issue Jan 24, 2019 · 2 comments
Closed

Switch to Jekyll #112

kahboom opened this issue Jan 24, 2019 · 2 comments

Comments

@kahboom
Copy link
Contributor

kahboom commented Jan 24, 2019

After much research and discussion, we'll be moving from Hugo to Jekyll for the community site. This will allow us to handle ascii-doctor better, making porting over and maintaining the Developer Handbook easier for contributors, and we'll also have access to a much more active and developed community.

@kahboom
Copy link
Contributor Author

kahboom commented Feb 6, 2020

cc @zregvart - Continuing the discussion about whether or not to host the docs on the syndesis.io repo or keeping them in the syndesis code base, I just wanted to point out that this issue was created with the intention of migrating the dev docs + handbook to the website repo.

I think this decision may need to be revisited to ensure that the people that currently contribute to it will actually continue to do so, or if they need it to stay where it is? If that's the case, we can still build the docs with CD/CI to make them available on the website in a way that looks like it's "native" to the site, or integrated (similar to #99 ).

@zregvart
Copy link
Member

zregvart commented Feb 6, 2020

I think the developers handbook, currently situated in doc/sdh of the syndesis git repository should be moved over to the website.

I think this would enable quicker turnaround on the editing and publishing of the developer documentation.

For the user documentation, most of the other directories/files in doc directory, that is other than sdh and system-tests, I think, it's better to have it versioned with the code. This will require additional work on the build of the website, or we could repurpose the existing domain doc.syndesis.io to host only the user documentation and publish it from a separate process, perhaps on stable release.

@kahboom kahboom closed this as completed Mar 4, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

2 participants