Re: Traffic Control Wiki Organization

[Dan Kirkwood]

+1


On Fri, Mar 3, 2017 at 4:59 PM, Jeremy Mitchell  wrote:
> thanks for doing that, Ashish. I would say go ahead and move pages to where
> they seem appropriate. That would be a great starting point. thanks again.
>
> Jeremy
>
> On Fri, Mar 3, 2017 at 10:44 AM, Durfey, Ryan 
> wrote:
>
>> Thanks Ashish for moving in all the old wiki pages from github!
>>
>> I was going to wait for page creators to review and organize but I realize
>> everyone is very busy.  If there are no objections by Monday morning, we
>> will move wiki pages to the new locations they appear to fit best.  If
>> someone finds something out of place feel free to correct.
>>
>> Ryan Durfey M | 303-524-5099
>>
>>
>> From: Ryan Durfey 
>> Date: Thursday, March 2, 2017 at 7:50 AM
>> To: "dev@trafficcontrol.incubator.apache.org" <
>> dev@trafficcontrol.incubator.apache.org>
>> Subject: Re: Traffic Control Wiki Organization
>>
>> Thanks Jeremy!  Great feedback. ☺
>>
>> Old Wiki:
>> I will work with Ashish to pull in all the existing pages from the old
>> Wiki and then the page stakeholders can decide on relevance, naming, and
>> organization.
>>
>> Published Docs vs. Cwiki Documentation:
>> I would argue that the cwiki relates to brainstorming on architecture and
>> development strategy and the published docs in
>> http://trafficcontrol.apache.org are
>> for documentation of completed development, but always open to debate.
>>
>> Organizing Pages:
>> I am happy to organize, but would rather push page creators and key
>> participants to consider the right place for their content so I am not
>> stepping on toes.  If people are good with the organization changes
>> proposed, just send me a note and I am happy to help make changes with at
>> least one key stakeholders consent.
>>
>> Ryan Durfey M | 303-524-5099
>>
>>
>> From: Jeremy Mitchell 
>> Reply-To: "dev@trafficcontrol.incubator.apache.org" <
>> dev@trafficcontrol.incubator.apache.org>
>> Date: Wednesday, March 1, 2017 at 7:39 PM
>> To: "dev@trafficcontrol.incubator.apache.org" <
>> dev@trafficcontrol.incubator.apache.org>
>> Subject: Re: Traffic Control Wiki Organization
>>
>> I think a little organization of the wiki page would prove to be very
>> helpful. Parent pages make sense to me. Also, I would not be opposed to you
>> moving some pages aroundalthough, i suppose that will change the URL of
>> the page, huh? But I still think if we spend a little time getting
>> organized and establishing a pattern, that will make our wiki much more
>> useful going forward.
>>
>> However, I am a bit confused about what goes on
>> http://trafficcontrol.apache.org vs. the wiki.
>>
>> Also, we still have a bunch of pages on the old wiki (
>> https://github.com/Comcast/traffic_control/wiki) that should be migrated
>> if
>> still relevant.
>>
>> Jeremy
>>
>> On Wed, Mar 1, 2017 at 5:58 PM, Durfey, Ryan > mailto:ryan_dur...@comcast.com>>
>> wrote:
>>
>> I have started adding parent pages for each platform like “Traffic Ops” so
>> that articles can be aggregated.  I will add comments to the existing pages
>> suggesting where to move.  Feel free to suggest alternatives.
>>
>> Ryan Durfey M | 303-524-5099
>>
>>
>> From: Ryan Durfey > comcast.com>>
>> Date: Monday, February 27, 2017 at 8:30 AM
>> To: "dev@trafficcontrol.incubator.apache.org> trafficcontrol.incubator.apache.org>" <
>> dev@trafficcontrol.incubator.apache.org> trafficcontrol.incubator.apache.org>>
>> Subject: Traffic Control Wiki Organization
>>
>>
>> I wanted to start some documentation around how pages should be organized
>> and named to make it easier for everyone to find information.  I wasn’t
>> sure whether to start that in an email thread or put it in the wiki for
>> comment so I am doing both.  Happy to help incorporate additional
>> suggestions or modify what I put in as per feedback.
>>
>> https://cwiki.apache.org/confluence/display/TC/Traffic+Control+Home
>>
>> Ryan
>>
>>
>>
>>

Re: Traffic Control Wiki Organization

[Durfey, Ryan]

Thanks Ashish for moving in all the old wiki pages from github!

I was going to wait for page creators to review and organize but I realize 
everyone is very busy.  If there are no objections by Monday morning, we will 
move wiki pages to the new locations they appear to fit best.  If someone finds 
something out of place feel free to correct.

Ryan Durfey M | 303-524-5099


From: Ryan Durfey 
Date: Thursday, March 2, 2017 at 7:50 AM
To: "dev@trafficcontrol.incubator.apache.org" 

Subject: Re: Traffic Control Wiki Organization

Thanks Jeremy!  Great feedback. ☺

Old Wiki:
I will work with Ashish to pull in all the existing pages from the old Wiki and 
then the page stakeholders can decide on relevance, naming, and organization.

Published Docs vs. Cwiki Documentation:
I would argue that the cwiki relates to brainstorming on architecture and 
development strategy and the published docs in 
http://trafficcontrol.apache.org are for 
documentation of completed development, but always open to debate.

Organizing Pages:
I am happy to organize, but would rather push page creators and key 
participants to consider the right place for their content so I am not stepping 
on toes.  If people are good with the organization changes proposed, just send 
me a note and I am happy to help make changes with at  least one key 
stakeholders consent.

Ryan Durfey M | 303-524-5099


From: Jeremy Mitchell 
Reply-To: "dev@trafficcontrol.incubator.apache.org" 

Date: Wednesday, March 1, 2017 at 7:39 PM
To: "dev@trafficcontrol.incubator.apache.org" 

Subject: Re: Traffic Control Wiki Organization

I think a little organization of the wiki page would prove to be very
helpful. Parent pages make sense to me. Also, I would not be opposed to you
moving some pages aroundalthough, i suppose that will change the URL of
the page, huh? But I still think if we spend a little time getting
organized and establishing a pattern, that will make our wiki much more
useful going forward.

However, I am a bit confused about what goes on
http://trafficcontrol.apache.org vs. the wiki.

Also, we still have a bunch of pages on the old wiki (
https://github.com/Comcast/traffic_control/wiki) that should be migrated if
still relevant.

Jeremy

On Wed, Mar 1, 2017 at 5:58 PM, Durfey, Ryan 
>
wrote:

I have started adding parent pages for each platform like “Traffic Ops” so
that articles can be aggregated.  I will add comments to the existing pages
suggesting where to move.  Feel free to suggest alternatives.

Ryan Durfey M | 303-524-5099


From: Ryan Durfey 
>
Date: Monday, February 27, 2017 at 8:30 AM
To: 
"dev@trafficcontrol.incubator.apache.org"
 <
dev@trafficcontrol.incubator.apache.org>
Subject: Traffic Control Wiki Organization


I wanted to start some documentation around how pages should be organized
and named to make it easier for everyone to find information.  I wasn’t
sure whether to start that in an email thread or put it in the wiki for
comment so I am doing both.  Happy to help incorporate additional
suggestions or modify what I put in as per feedback.

https://cwiki.apache.org/confluence/display/TC/Traffic+Control+Home

Ryan