Documentation tasks

Footer:

• Move Github so that it's the first link under "NDS Project Resources"

What should NDS Provide:

• Broken link to NDS Services Diagram (behind protected area in Wiki?)

Pilot projects:

• Add descriptions for: SBGrid, NIST (materials registry/curation), Pragma projects.

Get Involved

• Remove Trello link
• Move Github to first position

Labs:

• Implement edits from Revised NDS Labs Content

Pilot application

If we are going to maintain both the Workbench registration and pilot application, we'll need to update the pilot application.

• Distinguish from Workbench
• Remove labsportal link.
  
  

Open questions/Undecided

• "Get Involved" and top menu contain links to page to subscribe to mailing list – including discuss. We need to decide whether "discuss" will continue to be used.
• News is really out of date
• Do you have to have an approved pilot to access the Workbench? (Open question for TAC/Steering committee)
  • Pilots need to use Workbench to come up with the pilot idea
  • Workbench is one of the many services offered by NDS Labs
    • 2 cases: explore (pre-pilot test drive), develop (pilot)
    • Pre-pilot = NDSC member, RDA member?
      • We need NDSC developers that are not pilot members to have access to contribute tools
    • Pilots need more resources (e.g., PRAGMA) – outgrow Workbench
    • Workbench has two services: test drive and developer

• Redirect labsportal requests to http://www.nationaldataservice.org/projects/labs.htm

Remove all other content/decommission site

The NCSA Opensource confluence will be used primarily for development, project management, and in-progress documentation going forward.

• https://opensource.ncsa.illinois.edu/confluence/

• Identify and remove duplicate content

• Add a note pointing to official NDS Confluence documentation

• Confluence has pilots and projects conflated

Open questions

• Q. Should this be migrated to hosted Confluence (e.g., JIRA)
• Consider securing NDS space within NCSA Confluence - use this for internal notes

• Review public documentation
• Fill out more details on template stubs

• https://nationaldataservice.atlassian.net/wiki/

• Archive or add note that this is historic
• https://wiki.ncsa.illinois.edu/display/NDS/National+Data+Service+Home

• Update descriptions
• Ensure that videos make sense

• https://www.youtube.com/channel/UCWuPo7LDCzsqF3RaKzIQmHw

• Add links to new documentation
• Revisit description
• Add an FAQ?

• https://groups.google.com/forum/#!forum/ndslabs

• Update with new examples?
• Make sure old ones still work

• https://github.com/nds-org/developer-tutorial

• Add contents to the FAQ

• https://nationaldataservice.atlassian.net/wiki/display/NDSC/Frequently+Asked+Questions

• Review

Ready for Review

• https://nationaldataservice.atlassian.net/wiki/display/NDSC/User%27s+Guide
• Using Docker Images 
• Adding NDSLabs Services (this is an old draft)
• https://github.com/docker-library/official-images

• Finish filling out Developer Guide
• Needs more about authoring dockerfiles / builds / etc

• https://nationaldataservice.atlassian.net/wiki/display/NDSC/Developer%27s+Guide
• Building Custom Docker Images
• https://github.com/nds-org/developer-tutorial
• https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/

• Review Automated Builds

• https://hub.docker.com/search/?isAutomated=1&isOfficial=0&page=1&pullCount=0&q=ndslabs&starCount=0

• Review READMEs
• Delete unecessary repos
  • k8s-ingress
  • kubernetes
  • contrib?
  • invenio
  • data-provider
  • glopy
  • scidrive
• Flatten out Service repos
  • Remove k8 specs
  • Move Dockerfiles to root
• Clean-up Clowder

• Craig to add readme with link to github
  • Unable to actually add readme, but changed project URL

• https://opensource.ncsa.illinois.edu/bitbucket/projects/NDS
• https://bitbucket.org/nds-org/nds-labs

Unable to actually add readme, but changed project URL.

• Archive

• https://wiki.ncsa.illinois.edu/display/NDS/National+Data+Service+Home

• Make sure these reflect reality

• https://github.com/nds-org/ndslabs/tree/master/docs