Survey existing successful open source projects for best practices in web-page content and appearance

[smiths]

@danscime, please look at existing open source projects to identify the kind of information we should include on our web-page and how best to present it. Two good examples to look at are:

1. https://grass.osgeo.org/
2. https://mooseframework.org/

@Mornix was also planning on sending you another example. You should also feel free to find your own samples, or to consult with your colleagues for additional examples.

[smiths]

@danscime, I think one of the patterns you will see in successful open source projects from academia is a list of publications and presentations. I'm going to attach the current list of presentations related to Drasil. It would be great if we could get these on our web-page at some point. We should also incorporate links to the presentations slides and papers where feasible. Many of the slides are available in the Drasil repo in the Presentations folder. Some others can be found on-line. I can help you with this when we get to putting up this material.

Dissemination.pdf

[danscime]

Suggested by @Mornix https://llvm.org/

[danscime]

@smiths For a section that lists publications and presentations, should I list them in a format similar to the Dissemination.pdf you sent? Or should I list links? Or both together?

[smiths]

@danscime, I think you should use the last option - list the publications in full reference form, and include links.

[smiths]

@danscime, you should look at the guidelines here (found by @JacquesCarette) and see how our web-page stacks up to "best practices":

https://github.com/kylelobo/The-Documentation-Compendium

Has anything tangible come out of this exercise yet? Is there a list somewhere of the kinds of information and structure that others use on their web-pages?

[danscime]

Have not done too much of this yet, but will go through and create a list of features and notes from each site.

[smiths]

Sounds good!

[danscime]

Begun via a15ba74

[danscime]

Current list of features of existing projects

[smiths]

This is a good start @danscime. In a later pass it would be nice to see where the different projects overlap; that is, what things do they all have. In the end, I'll be interested in your recommendations on what we should add to our web-page. 😄