Docs output in master or gh-pages
See original GitHub issueRecently we changed the scaffold to use a different workflow for docs output.
Earlier we committed the docs into gh-pages
brach so that github would display it from there.
Now we commit the output directly to master.
I am very worried about that change since I fear this will lead to big merge conflicts in scenarios where we support multiple release branches or when different user release.
The original script avoided this because users integrated via master and gh-pages was only an automated step.
/cc @dsyme @pblasucci @isaacabraham @sergey-tihon @Krzysztof-Cieslak
Issue Analytics
- State:
- Created 6 years ago
- Comments:8 (3 by maintainers)
Top Results From Across the Web
Configuring a publishing source for your GitHub Pages site
Most external CI workflows "deploy" to GitHub Pages by committing the build output to the gh-pages branch of the repository, and typically include...
Read more >PSA: If you're using gh-pages to host your CI-generated ...
Given Smithay is still a very quickly-moving crate, we host generated docs for the master branch as well. Upvote 1
Read more >Can I define a custom source or folder from which my site ...
docs / folder on the master branch; gh-pages branch. So it doesn't look like you're able to define a custom folder or branch...
Read more >GitHub pages serving from docs and jekyll source folder ...
Recently, GitHub has changed the way serving pages work and now you can just serve the docs folder directly from the master branch....
Read more >Publish Your Project Documentation with GitHub Pages
Visit your repository's settings tab and select master branch /docs folder as the GitHub Pages source. Click save, and you're done.
Read more >Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start FreeTop Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
Top GitHub Comments
changing name of issue and labeling help wanted accepting PR to make configurable at init time
more background in this issue https://github.com/fsprojects/ProjectScaffold/issues/201 which I am closing in favor of keeping the discussion open here