Help talk:Notebook

From OpenWetWare
Revision as of 21:44, 11 April 2008 by Jason R. Kelly (talk | contribs) (Addition of example and screencast help a lot!)
Jump to: navigation, search

Possible tweaks to instructions

Steve Koch 00:05, 12 April 2008 (EDT):I am not sure whether this would be good to change the help page, but below are my suggested tweaks that would have helped my understanding (for lack of a better method, I'll color my changes red):

  • To set up your lab notebook you'll first need to create a few pages, cut and paste some starting wiki code and put them in the right places. As soon as they are set up, you'll be a click away from creating new lab notebook entries.
  • The required pages are:
    1. The Notebook page (You should create the page as [[User:Your UserName/Notebook]]. This page does not require a template. On your new lab notebook page, add a link to a new page by add the wiki code, [[/Test Project]])
    2. The Project page (This is the "Test Project" page you created a link to on your main notebook page. Cut and paste all of the wiki code from one of the following templates ((NOTE: Here is where I think it would be simpler to have them add a substitution template instead)Standard or iGEM template)
    3. The Entry Base page (Click on the "customize your entry pages" link to create the "entry base page". On this new page, cut and paste all of the wiki code from one of the following templates Standard or iGEM template)

Is it simpler to have users use a substitution template instead of "edit"+"cut and paste?"

E.g., have them add code like this:
     {{subst:Project Base}}
             {{subst:Entry Base}}

--Steve Koch 23:59, 11 April 2008 (EDT)

  • Steve Koch 00:17, 12 April 2008 (EDT):I tried this using the Template:Project Base and Template:Entry Base pages I created and it seemed to work. My opinion is that it's easier to explain how to setup things. (Because you can just say, cut and paste the following:
    {{subst:Project Page}}

Addition of example and screencast help a lot!

Steve Koch 23:51, 11 April 2008 (EDT):Jason and Ricardo -- the addition of the link to example notebook along with the screencast are a big help. I was able to set up my notebook, and while doing so, everything "clicked" and made sense finally. Thanks!

  • Jason R. Kelly 00:44, 12 April 2008 (EDT): Cool, thanks for the great comments above.