Re: [opnfv-tech-discuss] [docs] Cross Community Documentation effort

2018-04-17 Thread Thanh Ha
Hi Everyone,

Firstly I'd like to say that I plan to start moving this conversation over
to the mailing list. Please sign up to the new mailing list if you have no
done so already as future correspondence will be done via the list.

https://lists.linuxfoundation.org/mailman/listinfo/lf-docs

Also for those who use IRC our channel is #lf-docs @ irc.freenode.net

With that said I've finalized the Doodle
https://doodle.com/poll/dykpgubs3fvd2agw and it looks like Wednesdays at 5
PM UTC seems to be the winner. That is the following localized times if I'm
not mistaken:

10 AM PT
1 PM ET
7 PM Stockholm
3 AM Brisbane

(I believe Doodle will also show in your local time)

We need to pick a date, Sofia had a previous suggestion that it be the 3rd
week of the month but that would mean our first meeting is tomorrow which I
think would be too little notice. I was thinking maybe we can have our
first one next week instead and then following ones will be on the 3rd
Wednesday of every month. Thoughts?

If there's no strong opinions I will send out the invite tomorrow.

Thanks,
Thanh


On Thu, Apr 12, 2018 at 4:30 PM, Thanh Ha <thanh...@linuxfoundation.org>
wrote:

> Hi Everyone,
>
> I will pick a time next week. Just wanted to send a final reminder for
> folks who haven't filled out the doodle yet and would like to participate.
>
> https://doodle.com/poll/dykpgubs3fvd2agw
>
> Also please join the new lf-docs mailing list as we'll use that for future
> correspondence.
>
> https://lists.linuxfoundation.org/mailman/listinfo/lf-docs
>
> Thanks,
> Thanh
>
>
> On Tue, Apr 10, 2018 at 2:49 PM, Thanh Ha <thanh...@linuxfoundation.org>
> wrote:
>
>> Hi Everyone,
>>
>> I have acquired a mailing list for us to use moving forward. Please
>> subscribe to this one:
>>
>> https://lists.linuxfoundation.org/mailman/listinfo/lf-docs
>>
>> I have been told it will eventually migrate to groups.io but the
>> transition will be seamless for us so we can start using the mailman list
>> for now. I have also added the list to cc so this should be officially the
>> first email on the list.
>>
>> Thanks,
>> Thanh
>>
>>
>> On Thu, Apr 5, 2018 at 7:26 PM, Thanh Ha <thanh...@linuxfoundation.org>
>> wrote:
>>
>>> On Thu, Apr 5, 2018 at 6:03 PM, Thanh Ha <thanh...@linuxfoundation.org>
>>> wrote:
>>>
>>>> Hi Everyone,
>>>>
>>>> I believe I've included everyone who has indicated they were interested
>>>> in cross community docs efforts. If you are not interested feel free to
>>>> mute this thread.
>>>>
>>>> I've tried to include community mailing lists where existing to reach
>>>> hopefully the right audience for this email. If anyone knows of folks who
>>>> should be included please feel free to add them to this thread.
>>>>
>>>> At ONS we few of us from the ODL, OPNFV, and ONAP communities got
>>>> together to discuss some cross community documentation efforts we've been
>>>> pushing. We discussed lfdocs [0][1] and lfdocs-conf [2][3] projects who's
>>>> purpose is to enable projects to easily share common configuration as well
>>>> as create common documentation that projects can link to using
>>>> intersphinx linking rather than rewriting their own.
>>>>
>>>> One of the things that came out of the meeting was that it would be
>>>> good to create a cross-project-docs community so that we can ask questions
>>>> and share ideas since all of us are using very similar tooling to build our
>>>> docs.
>>>>
>>>> For a start I've created an IRC channel #lf-docs @ irc.freenode.net
>>>> which I hope folks will join and discuss docs related things in. It could
>>>> be a valuable resource rather than all of us hanging in our own small docs
>>>> communities I'm sure we are all understaffed as it is.
>>>>
>>>> We should setup a mailing list somewhere, I'll work with LF to figure
>>>> out where the best place for such a list is such that it is not specific to
>>>> any project.
>>>>
>>>> Also there was discussion about setting up some kind of regular meeting
>>>> maybe once a month where we can all get together and sync up to share any
>>>> ideas we have. I think there are 2 things we need to figure out together:
>>>>
>>>> 1. How often is the right amount as to not overload everyone with
>>>> meetings but give us time to get together?
>>>> 2. What is the best time for the meeting?
>>

Re: [opnfv-tech-discuss] [docs] Cross Community Documentation effort

2018-04-12 Thread Thanh Ha
Hi Everyone,

I will pick a time next week. Just wanted to send a final reminder for
folks who haven't filled out the doodle yet and would like to participate.

https://doodle.com/poll/dykpgubs3fvd2agw

Also please join the new lf-docs mailing list as we'll use that for future
correspondence.

https://lists.linuxfoundation.org/mailman/listinfo/lf-docs

Thanks,
Thanh


On Tue, Apr 10, 2018 at 2:49 PM, Thanh Ha <thanh...@linuxfoundation.org>
wrote:

> Hi Everyone,
>
> I have acquired a mailing list for us to use moving forward. Please
> subscribe to this one:
>
> https://lists.linuxfoundation.org/mailman/listinfo/lf-docs
>
> I have been told it will eventually migrate to groups.io but the
> transition will be seamless for us so we can start using the mailman list
> for now. I have also added the list to cc so this should be officially the
> first email on the list.
>
> Thanks,
> Thanh
>
>
> On Thu, Apr 5, 2018 at 7:26 PM, Thanh Ha <thanh...@linuxfoundation.org>
> wrote:
>
>> On Thu, Apr 5, 2018 at 6:03 PM, Thanh Ha <thanh...@linuxfoundation.org>
>> wrote:
>>
>>> Hi Everyone,
>>>
>>> I believe I've included everyone who has indicated they were interested
>>> in cross community docs efforts. If you are not interested feel free to
>>> mute this thread.
>>>
>>> I've tried to include community mailing lists where existing to reach
>>> hopefully the right audience for this email. If anyone knows of folks who
>>> should be included please feel free to add them to this thread.
>>>
>>> At ONS we few of us from the ODL, OPNFV, and ONAP communities got
>>> together to discuss some cross community documentation efforts we've been
>>> pushing. We discussed lfdocs [0][1] and lfdocs-conf [2][3] projects who's
>>> purpose is to enable projects to easily share common configuration as well
>>> as create common documentation that projects can link to using
>>> intersphinx linking rather than rewriting their own.
>>>
>>> One of the things that came out of the meeting was that it would be good
>>> to create a cross-project-docs community so that we can ask questions and
>>> share ideas since all of us are using very similar tooling to build our
>>> docs.
>>>
>>> For a start I've created an IRC channel #lf-docs @ irc.freenode.net
>>> which I hope folks will join and discuss docs related things in. It could
>>> be a valuable resource rather than all of us hanging in our own small docs
>>> communities I'm sure we are all understaffed as it is.
>>>
>>> We should setup a mailing list somewhere, I'll work with LF to figure
>>> out where the best place for such a list is such that it is not specific to
>>> any project.
>>>
>>> Also there was discussion about setting up some kind of regular meeting
>>> maybe once a month where we can all get together and sync up to share any
>>> ideas we have. I think there are 2 things we need to figure out together:
>>>
>>> 1. How often is the right amount as to not overload everyone with
>>> meetings but give us time to get together?
>>> 2. What is the best time for the meeting?
>>>
>>> For 2 I've created a doodle poll please ignore the dates as we are only
>>> interested in finding out during any given week which times are generally
>>> good for folks. Please respond with the times that are okay with you and
>>> we'll try to pick a time that is good for the most people.
>>>
>>> https://doodle.com/poll/dykpgubs3fvd2agw
>>>
>>> Regards,
>>> Thanh
>>>
>>> [0] http://docs.releng.linuxfoundation.org/en/latest/
>>> [1] https://gerrit.linuxfoundation.org/infra/#/admin/project
>>> s/releng/docs
>>> [2] http://docs.releng.linuxfoundation.org/projects/lfdocs-c
>>> onf/en/latest/index.html
>>> [3] https://gerrit.linuxfoundation.org/infra/#/admin/project
>>> s/releng/docs-conf
>>>
>>
>>
>> Adding some more folks to the list.
>>
>> Regards,
>> Thanh
>>
>>
>
___
opnfv-tech-discuss mailing list
opnfv-tech-discuss@lists.opnfv.org
https://lists.opnfv.org/mailman/listinfo/opnfv-tech-discuss


[opnfv-tech-discuss] Cross community lf-releng mailing list for global-jjb / lftools discussion

2018-04-10 Thread Thanh Ha
Hi Everyone,

Considering that we have more and more projects using global-jjb and other
tools like lftools we thought it would be appropriate to create a mailing
list for discussion related to these tools (and any other cross community
tools used by LF projects).

We created this list:

https://lists.linuxfoundation.org/mailman/listinfo/lf-releng

If you are interested in the development of global-jjb / lftools /
lfdocs-conf etc... please consider joining this new list. We'll be making
announcements related to these kinds of projects to this list in the future.

Please share with relevant folks who might be interested in this list.

Cheers,
Thanh
___
opnfv-tech-discuss mailing list
opnfv-tech-discuss@lists.opnfv.org
https://lists.opnfv.org/mailman/listinfo/opnfv-tech-discuss


Re: [opnfv-tech-discuss] [docs] Cross Community Documentation effort

2018-04-10 Thread Thanh Ha
Hi Everyone,

I have acquired a mailing list for us to use moving forward. Please
subscribe to this one:

https://lists.linuxfoundation.org/mailman/listinfo/lf-docs

I have been told it will eventually migrate to groups.io but the transition
will be seamless for us so we can start using the mailman list for now. I
have also added the list to cc so this should be officially the first email
on the list.

Thanks,
Thanh


On Thu, Apr 5, 2018 at 7:26 PM, Thanh Ha <thanh...@linuxfoundation.org>
wrote:

> On Thu, Apr 5, 2018 at 6:03 PM, Thanh Ha <thanh...@linuxfoundation.org>
> wrote:
>
>> Hi Everyone,
>>
>> I believe I've included everyone who has indicated they were interested
>> in cross community docs efforts. If you are not interested feel free to
>> mute this thread.
>>
>> I've tried to include community mailing lists where existing to reach
>> hopefully the right audience for this email. If anyone knows of folks who
>> should be included please feel free to add them to this thread.
>>
>> At ONS we few of us from the ODL, OPNFV, and ONAP communities got
>> together to discuss some cross community documentation efforts we've been
>> pushing. We discussed lfdocs [0][1] and lfdocs-conf [2][3] projects who's
>> purpose is to enable projects to easily share common configuration as well
>> as create common documentation that projects can link to using
>> intersphinx linking rather than rewriting their own.
>>
>> One of the things that came out of the meeting was that it would be good
>> to create a cross-project-docs community so that we can ask questions and
>> share ideas since all of us are using very similar tooling to build our
>> docs.
>>
>> For a start I've created an IRC channel #lf-docs @ irc.freenode.net
>> which I hope folks will join and discuss docs related things in. It could
>> be a valuable resource rather than all of us hanging in our own small docs
>> communities I'm sure we are all understaffed as it is.
>>
>> We should setup a mailing list somewhere, I'll work with LF to figure out
>> where the best place for such a list is such that it is not specific to any
>> project.
>>
>> Also there was discussion about setting up some kind of regular meeting
>> maybe once a month where we can all get together and sync up to share any
>> ideas we have. I think there are 2 things we need to figure out together:
>>
>> 1. How often is the right amount as to not overload everyone with
>> meetings but give us time to get together?
>> 2. What is the best time for the meeting?
>>
>> For 2 I've created a doodle poll please ignore the dates as we are only
>> interested in finding out during any given week which times are generally
>> good for folks. Please respond with the times that are okay with you and
>> we'll try to pick a time that is good for the most people.
>>
>> https://doodle.com/poll/dykpgubs3fvd2agw
>>
>> Regards,
>> Thanh
>>
>> [0] http://docs.releng.linuxfoundation.org/en/latest/
>> [1] https://gerrit.linuxfoundation.org/infra/#/admin/projects/releng/docs
>> [2] http://docs.releng.linuxfoundation.org/projects/lfdocs-
>> conf/en/latest/index.html
>> [3] https://gerrit.linuxfoundation.org/infra/#/admin/
>> projects/releng/docs-conf
>>
>
>
> Adding some more folks to the list.
>
> Regards,
> Thanh
>
>
___
opnfv-tech-discuss mailing list
opnfv-tech-discuss@lists.opnfv.org
https://lists.opnfv.org/mailman/listinfo/opnfv-tech-discuss


Re: [opnfv-tech-discuss] [docs] Cross Community Documentation effort

2018-04-09 Thread Thanh Ha
Hi Everyone,

Just a gentle reminder to fill out the doodle. I'm thinking I will leave
this open about another week before picking a date for the first meeting.

Thanks,
Thanh


On Thu, Apr 5, 2018 at 7:26 PM, Thanh Ha <thanh...@linuxfoundation.org>
wrote:

> On Thu, Apr 5, 2018 at 6:03 PM, Thanh Ha <thanh...@linuxfoundation.org>
> wrote:
>
>> Hi Everyone,
>>
>> I believe I've included everyone who has indicated they were interested
>> in cross community docs efforts. If you are not interested feel free to
>> mute this thread.
>>
>> I've tried to include community mailing lists where existing to reach
>> hopefully the right audience for this email. If anyone knows of folks who
>> should be included please feel free to add them to this thread.
>>
>> At ONS we few of us from the ODL, OPNFV, and ONAP communities got
>> together to discuss some cross community documentation efforts we've been
>> pushing. We discussed lfdocs [0][1] and lfdocs-conf [2][3] projects who's
>> purpose is to enable projects to easily share common configuration as well
>> as create common documentation that projects can link to using
>> intersphinx linking rather than rewriting their own.
>>
>> One of the things that came out of the meeting was that it would be good
>> to create a cross-project-docs community so that we can ask questions and
>> share ideas since all of us are using very similar tooling to build our
>> docs.
>>
>> For a start I've created an IRC channel #lf-docs @ irc.freenode.net
>> which I hope folks will join and discuss docs related things in. It could
>> be a valuable resource rather than all of us hanging in our own small docs
>> communities I'm sure we are all understaffed as it is.
>>
>> We should setup a mailing list somewhere, I'll work with LF to figure out
>> where the best place for such a list is such that it is not specific to any
>> project.
>>
>> Also there was discussion about setting up some kind of regular meeting
>> maybe once a month where we can all get together and sync up to share any
>> ideas we have. I think there are 2 things we need to figure out together:
>>
>> 1. How often is the right amount as to not overload everyone with
>> meetings but give us time to get together?
>> 2. What is the best time for the meeting?
>>
>> For 2 I've created a doodle poll please ignore the dates as we are only
>> interested in finding out during any given week which times are generally
>> good for folks. Please respond with the times that are okay with you and
>> we'll try to pick a time that is good for the most people.
>>
>> https://doodle.com/poll/dykpgubs3fvd2agw
>>
>> Regards,
>> Thanh
>>
>> [0] http://docs.releng.linuxfoundation.org/en/latest/
>> [1] https://gerrit.linuxfoundation.org/infra/#/admin/projects/releng/docs
>> [2] http://docs.releng.linuxfoundation.org/projects/lfdocs-
>> conf/en/latest/index.html
>> [3] https://gerrit.linuxfoundation.org/infra/#/admin/
>> projects/releng/docs-conf
>>
>
>
> Adding some more folks to the list.
>
> Regards,
> Thanh
>
>
___
opnfv-tech-discuss mailing list
opnfv-tech-discuss@lists.opnfv.org
https://lists.opnfv.org/mailman/listinfo/opnfv-tech-discuss


Re: [opnfv-tech-discuss] [docs] Cross Community Documentation effort

2018-04-05 Thread Thanh Ha
On Thu, Apr 5, 2018 at 6:03 PM, Thanh Ha <thanh...@linuxfoundation.org>
wrote:

> Hi Everyone,
>
> I believe I've included everyone who has indicated they were interested in
> cross community docs efforts. If you are not interested feel free to mute
> this thread.
>
> I've tried to include community mailing lists where existing to reach
> hopefully the right audience for this email. If anyone knows of folks who
> should be included please feel free to add them to this thread.
>
> At ONS we few of us from the ODL, OPNFV, and ONAP communities got together
> to discuss some cross community documentation efforts we've been pushing.
> We discussed lfdocs [0][1] and lfdocs-conf [2][3] projects who's purpose is
> to enable projects to easily share common configuration as well as create
> common documentation that projects can link to using intersphinx linking
> rather than rewriting their own.
>
> One of the things that came out of the meeting was that it would be good
> to create a cross-project-docs community so that we can ask questions and
> share ideas since all of us are using very similar tooling to build our
> docs.
>
> For a start I've created an IRC channel #lf-docs @ irc.freenode.net which
> I hope folks will join and discuss docs related things in. It could be a
> valuable resource rather than all of us hanging in our own small docs
> communities I'm sure we are all understaffed as it is.
>
> We should setup a mailing list somewhere, I'll work with LF to figure out
> where the best place for such a list is such that it is not specific to any
> project.
>
> Also there was discussion about setting up some kind of regular meeting
> maybe once a month where we can all get together and sync up to share any
> ideas we have. I think there are 2 things we need to figure out together:
>
> 1. How often is the right amount as to not overload everyone with meetings
> but give us time to get together?
> 2. What is the best time for the meeting?
>
> For 2 I've created a doodle poll please ignore the dates as we are only
> interested in finding out during any given week which times are generally
> good for folks. Please respond with the times that are okay with you and
> we'll try to pick a time that is good for the most people.
>
> https://doodle.com/poll/dykpgubs3fvd2agw
>
> Regards,
> Thanh
>
> [0] http://docs.releng.linuxfoundation.org/en/latest/
> [1] https://gerrit.linuxfoundation.org/infra/#/admin/projects/releng/docs
> [2] http://docs.releng.linuxfoundation.org/projects/
> lfdocs-conf/en/latest/index.html
> [3] https://gerrit.linuxfoundation.org/infra/#/admin/projects/releng/docs-
> conf
>


Adding some more folks to the list.

Regards,
Thanh
___
opnfv-tech-discuss mailing list
opnfv-tech-discuss@lists.opnfv.org
https://lists.opnfv.org/mailman/listinfo/opnfv-tech-discuss


[opnfv-tech-discuss] [docs] Cross Community Documentation effort

2018-04-05 Thread Thanh Ha
Hi Everyone,

I believe I've included everyone who has indicated they were interested in
cross community docs efforts. If you are not interested feel free to mute
this thread.

I've tried to include community mailing lists where existing to reach
hopefully the right audience for this email. If anyone knows of folks who
should be included please feel free to add them to this thread.

At ONS we few of us from the ODL, OPNFV, and ONAP communities got together
to discuss some cross community documentation efforts we've been pushing.
We discussed lfdocs [0][1] and lfdocs-conf [2][3] projects who's purpose is
to enable projects to easily share common configuration as well as create
common documentation that projects can link to using intersphinx linking
rather than rewriting their own.

One of the things that came out of the meeting was that it would be good to
create a cross-project-docs community so that we can ask questions and
share ideas since all of us are using very similar tooling to build our
docs.

For a start I've created an IRC channel #lf-docs @ irc.freenode.net which I
hope folks will join and discuss docs related things in. It could be a
valuable resource rather than all of us hanging in our own small docs
communities I'm sure we are all understaffed as it is.

We should setup a mailing list somewhere, I'll work with LF to figure out
where the best place for such a list is such that it is not specific to any
project.

Also there was discussion about setting up some kind of regular meeting
maybe once a month where we can all get together and sync up to share any
ideas we have. I think there are 2 things we need to figure out together:

1. How often is the right amount as to not overload everyone with meetings
but give us time to get together?
2. What is the best time for the meeting?

For 2 I've created a doodle poll please ignore the dates as we are only
interested in finding out during any given week which times are generally
good for folks. Please respond with the times that are okay with you and
we'll try to pick a time that is good for the most people.

https://doodle.com/poll/dykpgubs3fvd2agw

Regards,
Thanh

[0] http://docs.releng.linuxfoundation.org/en/latest/
[1] https://gerrit.linuxfoundation.org/infra/#/admin/projects/releng/docs
[2]
http://docs.releng.linuxfoundation.org/projects/lfdocs-conf/en/latest/index.html
[3]
https://gerrit.linuxfoundation.org/infra/#/admin/projects/releng/docs-conf
___
opnfv-tech-discuss mailing list
opnfv-tech-discuss@lists.opnfv.org
https://lists.opnfv.org/mailman/listinfo/opnfv-tech-discuss