Finding the data for the lesson

[carpentries]

Finding the data for the lesson

[rgaiacs]

Tracy, Naupaka, Trever, Remi and I got in consensus of

Include a brief mention in the prereq block and link to setup (so that people are more likely to find it).

[gvwilson]

A lesson's authors can add a link to a data set on the home page - should we resurrect the idea of 'Setup' as a callout box rather than a separate page, and encourage people to always put it on the home page?

[tracykteal]

I also filed an issue on the Python lesson where it was noticed. swcarpentry/python-novice-inflammation#302

Since the data is so important though, I think it would be good to have a standard location for it, so instructors always know where to find it.

[gvwilson]

@k8hertweck can we please ask the maintainers whether we should:

1. Include instructions in the prereq block on the home page and get rid of setup.md.
2. Include a brief mention in the prereq block and link to setup (so that people are more likely to find it).
3. Something else.

[rgaiacs]

@k8hertweck Did you ask the maintainers?

[wking]

On Wed, Feb 08, 2017 at 09:53:05AM -0800, Raniere Silva wrote: > Include a brief mention in the prereq block and link to setup (so > that people are more likely to find it).

And we do link to setup from both the nav bar [1] and the index page [2]. I think we want to: * Move the ‘setup’ reference from just before the prereq block into the prereq block. * Mention in the referencing text that the setup link also covers any required data. * Mention in [3,4] that setup.md should also cover any required data. [1]: https://github.com/swcarpentry/lesson-example/blob/gh-pages/_includes/navbar.html#L53 [2]: https://github.com/swcarpentry/lesson-example/blame/4a744d734850bc90bf01f7618433a6ebc10d1384/index.md#L12 [3]: https://github.com/swcarpentry/lesson-example/blob/4a744d734850bc90bf01f7618433a6ebc10d1384/setup.md [4]: https://github.com/swcarpentry/board/blob/45f7e9606e58c85cc9fbf3f534416b39fd74a7a2/subcommittees/maintainers/installation-instructions.md