Documentation tasks

NDSC6

Document	Priority	Notes	Assignee	Reviewer	Related Link(s)
Official NDS Domain	High	http://www.nationaldataservice.org/ footer contains link to out-of-date Wiki http://www.nationaldataservice.org/ footer and "Get involved" contain links to Bitbucket http://www.nationaldataservice.org/ "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. "Pilots" page does not mention SBGrid or highlight NIST materials registry/curation systems. Revisit / review the "Labs" page, which is largely inaccurate			http://www.nationaldataservice.org/ NDS-156 - Getting issue details... STATUS
Labs Portal	High	Decommission wordpress site Move any relevant info to NDS Confluence Redirect labsportal requests to something... Confluence? Beta?			http://labsportal.nationaldataservice.org/
NCSA Confluence	High	Remove duplicate content Add a note pointing to official NDS Confluence documentation Consider securing NDS space within NCSA Confluence - use this for internal notes			https://opensource.ncsa.illinois.edu/confluence/
NDS Confluence	High	Review public documentation			https://nationaldataservice.atlassian.net/wiki/
YouTube Channel	High	Update descriptions Ensure that videos make sense			https://www.youtube.com/channel/UCWuPo7LDCzsqF3RaKzIQmHw
Google Group	High	Add links to new documentation Revisit description Add an FAQ?			https://groups.google.com/forum/#!forum/ndslabs
Tutorial repo with examples	High	Update with new examples? Make sure old ones still work	Mike	Craig	https://github.com/nds-org/developer-tutorial
User Guide	High	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
Developer Guide	High	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/

Docker Hub	Medium	Review Automated Builds			https://hub.docker.com/search/?isAutomated=1&isOfficial=0&page=1&pullCount=0&q=ndslabs&starCount=0
GitHub	Medium	Review READMEs Delete unecessary repos k8s-ingress data-provider glopy scidrive Flatten out Service repos Remove k8 specs Move Dockerfiles to root Clean-up Clowder			https://github.com/nds-org/ndslabs https://github.com/nds-org/ndslabs-specs https://github.com/nds-org/ndslabs-devenvs Individual Services: dataverse irods dspace etc
BitBucket	Medium	Contact Matt Turk Decommission legacy BitBucket repo(s)			https://opensource.ncsa.illinois.edu/bitbucket/projects/NDS https://bitbucket.org/nds-org/nds-labs
Other Wikis?	Low	Archive			https://wiki.ncsa.illinois.edu/display/NDS/National+Data+Service+Home
Architecture Docs	Low	Make sure these reflect reality			https://github.com/nds-org/ndslabs/tree/master/docs

NDSC5

Document	Priority	Notes	Assigned to	Reviewer	Status	Related Link(s)
Update labsportal Wordpress	High		Kenton	?		http://labsportal.nationaldataservice.org/
Tutorial repo with examples	High		Mike	Craig	Ready for review	https://github.com/nds-org/developer-tutorial
Tutorial presentation	High		Craig	Mike/David		2016-03-28 Tutorial planning https://docs.google.com/presentation/d/1Ll0EwFpVXVdZAM44tBeT5q_mq7WXIwBDup4Km7Np37o/edit#slide=id.p
Clowder/Terra demo video	High	Need to work with Craig to make sure titles/subtitles consistent	Mike	Craig	Ready for review	https://uofi.app.box.com/files/0/f/5363912561/Videos
Dataverse/iRods demo video	High		Craig	Mike	As good as it's going to be	https://uofi.app.box.com/files/0/f/5363912561/Videos
ndslabs-system-shell readme	High		David			https://github.com/nds-org/ndslabs-system-shell
NDSLabs build/installation instructions	High	Needs consolidation	Craig	Mike		https://github.com/nds-org/ndslabs/tree/master/apiserver https://github.com/nds-org/ndslabs/tree/master/apictl https://github.com/nds-org/ndslabs/tree/master/gui https://github.com/nds-org/ndslabs/blob/master/docs/setup.md
~~ndslabs repo readme~~	~~High~~	~~Needs community information~~	~~Craig~~	~~Mike~~		~~https://github.com/nds-org/ndslabs~~
~~ndslabs-specs repo readme~~	~~High~~	~~Mike -> Craig: Looks good, I think?~~	~~Craig/Mike~~	~~Mike/Craig~~	~~Done~~	~~https://github.com/nds-org/ndslabs-specs~~
~~ndslabs-clowder repo readme~~	~~High~~	~~Craig: Looks good.~~	~~Mike~~	~~Craig~~	~~Ready for review~~	~~https://github.com/nds-org/ndslabs-clowder~~ ~~https://github.com/nds-org/ndslabs-clowder/tree/master/dockerfiles~~ ~~https://github.com/nds-org/ndslabs-clowder/tree/master/kubernetes~~
~~ndslabs-dataverse readme~~	~~High~~	Mike -> Craig: Looks good	~~Craig~~	~~Mike~~	~~Ready for review~~	~~https://github.com/nds-org/ndslabs-dataverse~~
ndslabs-developer-shell readme	Med		David			https://github.com/nds-org/ndslabs-developer-shell
Best-practices for Dockerfile creation	Med	Needs more best practices / consolidation	Mike	Craig		Using Docker Images Building Custom Docker Images https://github.com/nds-org/developer-tutorial https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/ https://github.com/docker-library/official-images
Best practices for service creation	Med	Needs consolidation	Craig	Mike		Adding NDSLabs Services (this is an old draft) https://github.com/nds-org/developer-tutorial https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/ https://github.com/docker-library/official-images
~~ndslabs-irods readme~~	~~Med~~	~~Mike -> Craig:~~ ~~Would it be beneficial to link to irods-federate / dataverse in 'See also'?~~	~~Craig~~	~~Mike~~	~~Ready for review~~	~~https://github.com/nds-org/ndslabs-irods~~
~~ndslabs-irods-federate readme~~	~~Med~~	~~Mike -> Craig:~~ ~~A bit sparse.. may need build / run instructions if its much more complicated than 'make' or './build.sh'~~	~~Craig~~	~~Mike~~	~~Ready for review~~	~~https://github.com/nds-org/ndslabs-irods-federate~~
~~Document apiserver.conf~~	~~Med~~		~~Craig~~	~~Mike~~	~~Ready or review~~	~~https://github.com/nds-org/ndslabs/tree/master/apiserver#configuration~~
Dockerhub repo documentation?	Low	If we have time
ELK demo video	Low		Craig	Mike		TBA
Dataverse/TwoRavens demo	Low		Craig	Mike		TBA
ndslabs-deploy-tools readme	Low		David			https://github.com/nds-org/ndslabs-deploy-tools
~~ndslabs-all-sources readme~~	Low		~~David~~			~~https://github.com/nds-org/ndslabs-all-sources~~
~~nds-labs-legacy readme~~	Low					~~https://github.com/nds-org/nds-labs-legacy~~

Space shortcuts

Page tree

NDSC6

NDSC5