Documentation: Develop landing pages that enable the community to easily find up-to-date information on a WSSSPE topic

[danielskatz]

Develop landing pages on the WSSSPE website (or elsewhere) that enable the community to easily find up-to-date information on a WSSSPE topic (e.g., software credit, scientific software metrics, testing scientific software)

[dangunter]

First thing that comes to mind is to use this repo, add one markdown file per topic in a directory.

[npch]

I think I was one of the people that originally suggested this topic.

Whilst I think that collaboratively editing the Markdown files in GitHub is a good way of ensuring they're easy for WSSSPE contributors to edit, I think that having them in a directory in GitHub isn't a good way of publishing them to the wider community, particularly those who are coming from outside the software part of the community. So perhaps we should have an automated way of publishing them to a website?

[dangunter]

We could put them in a "gh-pages" branch of this repo then they'll go to a web page on github.io automagically, as per https://pages.github.com/ . Or we could use WordPress or something -- I was just trying to keep us in software-engineering land.

[npch]

GitHub webpages work for me.

[sandragesing]

I still like to have it on GitHub. For software developers it shouldn't be
a problem at all and for people outside the software community the hurdle
is quite low to contribute (in my humble opinion). github.io sounds good to
me.

---

Sandra Gesing
Research Assistant Professor, Department of Computer Science and Engineering
Computational Scientist, Center for Research Computing
University of Notre Dame

http://www3.nd.edu/~sgesing

On Mon, Sep 28, 2015 at 11:32 AM, Dan Gunter notifications@github.com
wrote:

We could put them in a "gh-pages" branch of this repo then they'll go to a
web page on github.io automagically, as per https://pages.github.com/ .
Or we could use WordPress or something -- I was just trying to keep us in
software-engineering land.

—
Reply to this email directly or view it on GitHub
#59 (comment).

[kyleniemeyer]

The GitHub page seems like a great way to set up a nice landing page that is connected to the WSSSPE community. (Also, Jekyll is pretty easy/fun to use... it runs my personal website.)

[ndjones]

we (@erinmr and I) independently came up with the same idea (a jekyll site or github pages) ;)
it must be a good one!

[dangunter]

We could also use netlify https://www.netlify.com/ (or a competitor)