home page should look friendlier

[prjemian]

• close Make installation checklist and installation guide header consistent #283
• close DOC: new instrument setup assistance #284
• close DOC: Order of docs should be changed #285
• close re-arrange the home page (of the web site) #288
• close What are the next steps after the initial installation? #295
• close DOC: broken link #298

[prjemian]

[prjemian]

Might get a lot easier if we add the sphinx-design package.

[prjemian]

(That's what bluesky-adaptive is using)

[prjemian]

Half the lines of code, no need for raw html, easier to manage.

[prjemian]

Download a preview copy of the web site for review from docs actions page. The download is at/near the bottom of the page.

[coveralls]

Pull Request Test Coverage Report for Build 8882659580

Warning: This coverage report may be inaccurate.

This pull request's base commit is no longer the HEAD commit of its target branch. This means it includes changes from outside the original pull request, including, potentially, unrelated coverage changes.

• For more information on this, see Tracking coverage changes with pull request builds.
• To avoid this issue with future PRs, see these Recommended CI Configurations.
• For a quick fix, rebase this PR at GitHub. Your next report should be accurate.

Details

• 0 of 0 changed or added relevant lines in 0 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage remained the same at 82.675%

---

Totals
Change from base Build 8543931001:	0.0%
Covered Lines:	983
Relevant Lines:	1189

---

💛 - Coveralls

[rodolakis]

I actually find this a lot better - much less overwhelming. I can tell exactly where I want to go. I don't really see any value in the preview of "some" of the content. I'd rather just pick a category, and then browse from there.

[prjemian]

[prjemian]

View of checklist now (text is pulled from the section title by Sphinx):

[prjemian]

One more step, at least, to modularize the content after the installation checklist. See TODO items, such as

bluesky_training/docs/source/instrument/install_new_instrument.rst

Line 22 in dc30425

.. TODO: Could move each section to its own file.

[prjemian]

Published latest version to public website.

• home: https://bcda-aps.github.io/bluesky_training/
• checklist: https://bcda-aps.github.io/bluesky_training/instrument/install_new_instrument.html#instrument-install

Ready for review.

[MDecarabas]

Home page looks great! The one change I would make to the new instrument setup is putting (optional) next to the steps that are not mandatory. Ie: creating an alias

[prjemian]

@MDecarabas -- re-examine the checklist: https://bcda-aps.github.io/bluesky_training/instrument/install_new_instrument.html#instrument-install

[MDecarabas]

Great!

[prjemian]

Thanks MDecarabas!

[rodolakis]

Looks great!