Google Git
Sign in
apache / fluo-website / e98870934cf77805a7506acf0b52aabb06782604
commite98870934cf77805a7506acf0b52aabb06782604[log] [tgz]
authorben <git@benjamin.ie>Thu Jul 30 23:16:00 2020 +0100
committerGitHub <noreply@github.com>Thu Jul 30 18:16:00 2020 -0400
tree6e8f9e49b1c44ed3ec28ac8b494a7daab8d56493
parent0c5b58a022b098904075ae7a516c3801e80f1214 [diff]
Added benkelly to Contributors (#193)

- for [`apache/fluo-uno#249`](https://github.com/apache/fluo-uno/pull/249)

Signed-off-by: ben <git@benjamin.ie>
1 file changed
tree: 6e8f9e49b1c44ed3ec28ac8b494a7daab8d56493
  1. _data/
  2. _fluo-1-2/
  3. _includes/
  4. _layouts/
  5. _posts/
  6. _recipes-1-2/
  7. _sass/
  8. _scripts/
  9. css/
  10. doap/
  11. docs/
  12. js/
  13. pages/
  14. resources/
  15. tour/
  16. .gitignore
  17. .htaccess
  18. _config.yml
  19. CONTRIBUTING.md
  20. feed.xml
  21. Gemfile
  22. Gemfile.lock
  23. index.html
  24. LICENSE
  25. README.md
  26. search_data.json
README.md

Apache Fluo website

Code powering the Apache Fluo website (https://fluo.apache.org). Contributing describes how to test locally.

Update website for new release

Below are the steps required to update the Fluo project website for a new release of Fluo or Fluo Recipes. The steps below assume you are releasing Fluo 1.2.0. For a Fluo Recipes release, replace any reference to fluo with recipes.

  1. Confirm that Javadocs for the release are hosted externally

  2. Modify _config.yml for the new release:

    • Set latest_fluo_release to 1.2.0
    • Verify default values (i.e Javadoc & GitHub URLs) set for fluo-1-2 collection

  3. Remove the “Future release” warning from the Fluo docs layout in _layouts/fluo-1.2.html

  4. Add link to 1.2 documentation in docs/index.md.

  5. Add link to 1.2 javadocs in pages/api.md.

  6. If a post exists for the release in _posts/release, update the date and remove draft: true from the post to publish it. Otherwise, create a post with release notes and resources to announce the release.

Create documentation for next release

Below are steps to create documentation for the next release of Fluo or Fluo Recipes. The directions below are for creating Fluo 1.3 docs from 1.2 docs. For Fluo Recipes documentation, replace any reference to fluo with recipes.

  1. Create the Fluo 1.3 docs from the 1.2 docs

     cp -r _fluo-1-2 _fluo-1-3

  2. Create a fluo-1.3.html layout and update any collection references in it to fluo-1-3. You should also add a warning banner to notify users that it's for a future release.

     cp _layouts/fluo-1.2.html _layouts/fluo-1.3.html
 vim _layout/fluo-1.3.html

  3. Update _config.yml by adding a fluo-1-3 collection and setting default values for it. You may want to keep 1.2 values for github & javadocs until 1.3 is released.

Committer instructions

To publish Fluo's website the gh-pages branch must be rendered into the asf-site branch. The script _scripts/git-hooks/post-commit automates rendering into the asf-site branch. The commands below serve as a guide for committers who wish to publish the web site.

 # ensure local asf-site branch is up to date
 git checkout asf-site 
 git pull upstream asf-site

 # switch to gh-pages branch, update it, and build new site 
 git checkout gh-pages
 git pull upstream gh-pages 
 ./_scripts/git-hooks/post-commit 

 # switch to asf-site, look at the commit created by post-commit script, and push it if ok
 git checkout asf-site 
 git log -p
 git push upstream asf-site

In the commands above upstream is

$ git remote -v | grep upstream
upstream	https://gitbox.apache.org/repos/asf/fluo-website/ (fetch)
upstream	https://gitbox.apache.org/repos/asf/fluo-website/ (push)``