Transition Technology: Ticket #467: Documentation

hours, totalhours changed; cc set

chris — Wed, 28 Nov 2012 22:41:25 GMT

cc chris added
hours changed from 0.0 to 0.5
totalhours changed from 0.0 to 0.5

Replying to ed:

-- protocols for contributing to the wiki and the issue tracker,

I have created a Trac account for Mark and granted him the same permissions as the rest of us, see:

https://tech.transitionnetwork.org/trac/admin/general/perm

I have also updated the wiki:TracUserAdmin page.

I have also set Mark up with ssh access to both wiki:NewLiveServer and wiki:DevelopmentServer.

cc, owner, status changed

ed — Thu, 29 Nov 2012 09:43:16 GMT

cc ed added
owner changed from ed to mark
status changed from new to assigned

Mark added as ticket owner

chris — Tue, 04 Dec 2012 09:47:44 GMT

One thought on this, we we do switch to using Octopus / Ageir (see ticket:466), then that is the process and system we need to sort out and document rather than the current process / set up.

ed — Tue, 04 Dec 2012 12:42:26 GMT

Confirmed - good thinking

description changed

mark — Tue, 29 Jan 2013 10:07:43 GMT

description modified (diff)

Right. I'm rattling on with this now. It's late in the day because (a) there's been some other crap to deal with at my end, but also (b) the BOA process hasn't seemed stable/finished (from my possibly mistaken perspective, anyway).

I'm going to target the "specification/description of the site" and the "protocols for contributing to the wiki and the issue tracker" bits of the above work immediately, as they're straightforward.

With the BOA stuff, can I or should I attempt to:

create a site with BOA
use BOA to clone my site (dev)
create myself a local copy of the dev site
change my local copy of the dev site
merge my local copy of the dev site with the BOA-hosted dev site
back in BOA, merge the dev site back into the live site

...because this is what the website development process will be, won't it?

hours, totalhours changed

mark — Tue, 29 Jan 2013 10:09:49 GMT

hours changed from 0.0 to 3.0
totalhours changed from 0.5 to 3.5

Just logging 3 hours work on this to date, covering reading around, planning and preparing.

hours, totalhours changed

mark — Tue, 29 Jan 2013 12:33:28 GMT

hours changed from 0.0 to 1.66
totalhours changed from 3.5 to 5.16

Have just got the bare bones of some website documentation on the Wiki: https://tech.transitionnetwork.org/trac/wiki#Websitedevelopersdesigners-starthere https://tech.transitionnetwork.org/trac/wiki/TransitionNetworkWebsite

hours, totalhours changed

mark — Thu, 07 Mar 2013 11:05:18 GMT

hours changed from 0.0 to 1.66
totalhours changed from 5.16 to 6.82

On Tuesday, I drafted this page: https://trac.transitionnetwork.org/trac/wiki/HomePageExplained

hours, totalhours changed

mark — Thu, 07 Mar 2013 12:52:44 GMT

hours changed from 0.0 to 1.44
totalhours changed from 6.82 to 8.26

Just completed the info-graphic for a Views page/section: https://trac.transitionnetwork.org/trac/wiki/ViewBreakdown

mark — Tue, 19 Mar 2013 13:52:42 GMT

Drafted "Drupal best practice": https://trac.transitionnetwork.org/trac/wiki/TransitionNetworkWebsite#Drupalbestpractice

Added brief intro to Panels & Context: https://trac.transitionnetwork.org/trac/wiki/TransitionNetworkWebsite#PanelsContext-layoutandBlockmanagement

Trimmed down Drupal intro to be more newb-friendly and better pre-echo the rest of the documentation: https://trac.transitionnetwork.org/trac/wiki/TransitionNetworkWebsite#Drupal

Next up:

Need to add detail to these sections, and I think break them up into seperate pages.
Need to start adding in the technical docs/workflow - although I think I'm still waiting on Jim for this.

mark — Tue, 19 Mar 2013 13:54:48 GMT

I've done just over a quarter of the 4 days agreed for the documentation work I'm doing. I hope now to pick up the pace and fit in the remaining 3 days over the next 2 weeks - completing the work by the end of March.

ed — Tue, 19 Mar 2013 14:48:24 GMT

Great - Jim is hoping to work on the BOA processes and related documentation this week

status changed; resolution set

ed — Wed, 08 May 2013 16:39:54 GMT

status changed from assigned to closed
resolution set to fixed

Closing this as it's done