Re: [xdi] work on wiki..

[Drummond Reed <drummond.reed@xdi.org>]

Thanks to the initial push from Markus, I just spent a few hours completing the refactoring and cleanup of the XDI TC wiki FrontPage:

The introductory "Quickstart Guide" table is now what I think Bill originally envisioned. It is no longer necessary to list a new proposal there at all - rather you can just click the link to a page I added called New Pages to add a new page. Then make sure you tag the page with the correct Category tags as explained in Proposal Drafting and it will automatically show up on all the appropriate category pages.

Now we can really start running through the proposal submission and decision queue process efficiently.

=Drummond  

On Mon, Jul 30, 2012 at 1:56 PM, Drummond Reed <drummond.reed@xdi.org> wrote:

On Mon, Jul 30, 2012 at 6:33 AM, Markus Sabadello <markus.sabadello@xdi.org> wrote:

Hello,

I did some work on the TC wiki:

Markus, great job, thanks for taking the ball on this.

 

- Removed proposals from the front page that have already been put into the appropriate category, to avoid redundancy

Perfect - just what we agreed on Friday's call.

 

- It didn't feel right to me to just mark all of Mike's proposals as "CategoryObsolete". I think we need a formal process for that, maybe Bill could write up something regarding obsolete proposals on the XdiProposalDrafting page.

I wasn't thinking that of a "CategoryObsolete". I was thinking we'd call it "CategoryInactive". Any proposal that was no longer actively being proposed, i.e., the TC member proposing it was no longer active (e.g., Mike), or, even if the TC member was still active, if they no longer considered the proposal active, then it would go into that category.

Since we do need to establish that category so we can finish categorized the rest of the proposals currently on the FrontPage, I just added documented how to mark a proposal as inactive on the XdiProposalDrafting page:

   https://wiki.oasis-open.org/xdi/XdiProposalDrafting

I will create the CategoryInactive page now and tag the rest of the proposals that are now inactive to appear there. If we decide to activate any of them in the future, it's just one quick wiki edit to retag it.

 

- Added a few proposals to CategoryApi, especially about $add and $del operations. Maybe we can review the general pattern of these proposals. If they look okay, we can create more of the same kind.

Good. Is that something that you want to to discuss on this Friday's call?

 

- Added more categories, now we have CategoryGraphModel, CategorySerialization, CategoryApi, CategoryDictionary, CategoryDiscovery, CategoryLinkContracts, CategoryQueries

Thank you for doing that.

 

- On the XdiProposalDrafting page, removed the instruction saying that new proposals have to be added to the front page

Good catch.

 

- I can see that on the front page there are lines "New pages this week" and "Changed this week". I'm sorry, maybe I don't remember, are we supposed to maintain a list here manually?

I'm not sure we need that any more - all folks should need to do is review the CategoryCurrent and CategoryHighPriority pages to see what they should be focusing on.

Bill?

=Drummond