19:01:58 <ShillaSaebi> #startmeeting docteam
19:02:00 <openstack> Meeting started Wed May 25 19:01:58 2016 UTC and is due to finish in 60 minutes.  The chair is ShillaSaebi. Information about MeetBot at http://wiki.debian.org/MeetBot.
19:02:01 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote.
19:02:03 <openstack> The meeting name has been set to 'docteam'
19:02:07 <ShillaSaebi> hello everyone
19:02:15 <ShillaSaebi> who do we have here for the docs meeting?
19:02:17 <ShillaSaebi> roll call!
19:02:32 <Sam-I-Am> hi
19:02:41 <strigazi> Spyros Trigazis (magnum)
19:02:48 <ShillaSaebi> hola!
19:03:12 <ShillaSaebi> just the 3 of us?
19:03:22 <strigazi> think so
19:03:33 <ShillaSaebi> ok
19:03:35 <ShillaSaebi> well then
19:03:40 <ShillaSaebi> guess we can go ahead and get started
19:03:58 <Sam-I-Am> yep
19:04:21 <ShillaSaebi> #topic Action items from the last meeting
19:04:23 <ShillaSaebi> none
19:05:10 <Sam-I-Am> well, i was supposed to write up an email about lack of dev contributions to docs
19:05:11 <ShillaSaebi> #topic Specs in review #link https://review.openstack.org/#/q/status:open+project:openstack/docs-specs,n,z
19:05:27 <Sam-I-Am> lana sort of opened that can of worms in her weekly docs e-mail, but no one responded to it
19:05:41 <ShillaSaebi> "Sam-I-Am to start thread on dev doc contributions"
19:05:50 <ShillaSaebi> yeah i figured that it went out
19:05:50 <Sam-I-Am> also no further replies to my original email to the dev list
19:05:56 <ShillaSaebi> :O
19:05:57 <Sam-I-Am> so i'm guessing no one really cares
19:06:14 <Sam-I-Am> which i dont like, but it is what it is
19:06:35 <Sam-I-Am> sort of tells me we need more active recruiting of devs from each project
19:06:38 <ShillaSaebi> yeah
19:06:42 <Sam-I-Am> they need to learn from magnum :)
19:06:48 <strigazi> :)
19:06:56 <ShillaSaebi> yep
19:06:59 <ShillaSaebi> hehe
19:07:00 <Sam-I-Am> its really nice to have someone here from a project
19:07:17 <ShillaSaebi> let me look at the APAC meeting log
19:07:21 <ShillaSaebi> and see if maybe we have more join there?
19:07:28 <Sam-I-Am> sure, but its usually quiet
19:07:44 <strigazi> It was like 15 mins
19:07:51 <strigazi> 3 or 4 people
19:08:02 <ShillaSaebi> loquacities, JRobinson__ , katomo, rstarmer
19:08:02 <strigazi> I checked the log last week
19:08:14 <ShillaSaebi> yeah so 4 peeps
19:08:57 <ShillaSaebi> alright well what are our next steps
19:09:12 <strigazi> I have some questions
19:09:16 <ShillaSaebi> shoot
19:09:40 <Sam-I-Am> well...
19:09:40 <strigazi> A team member of magnum needs to document magnum's api
19:09:58 <strigazi> We have this: http://docs.openstack.org/cli-reference/magnum.html
19:10:03 <Sam-I-Am> i think my new e-mail idea changes to us getting more active recruiting rather than hoping people show up
19:10:36 <ShillaSaebi> ok
19:10:40 <strigazi> I don't know in which repo this resided
19:10:44 <strigazi> resides
19:11:11 <strigazi> is it a repo from doc-team?
19:11:39 <Sam-I-Am> the api is sort of moving
19:11:40 <ShillaSaebi> oh yeah
19:11:46 <Sam-I-Am> api docs, rather
19:12:14 <ShillaSaebi> #link https://github.com/openstack/openstack-manuals
19:12:36 <Sam-I-Am> the cli-reference is different from the api
19:12:39 <Sam-I-Am> which are we talking about?
19:12:59 <strigazi> let me check
19:13:11 <strigazi> api
19:13:25 <ShillaSaebi> should be in cli-reference right?
19:13:34 <strigazi> oh he wants to do both :)
19:14:06 <ShillaSaebi> ok
19:14:57 <strigazi> both must be pushed on openstack-manuals?
19:15:04 <Sam-I-Am> it seems like we're moving api docs into project trpos
19:15:05 <Sam-I-Am> repos
19:15:25 <Sam-I-Am> strigazi: i suggest you read existing posts about api on the docs mailing list, or post to it about how to try the new api docs mechanism
19:15:29 <Sam-I-Am> but iirc, they're moving into the repos
19:15:59 <strigazi> similar to install-guide I guess
19:16:28 <Sam-I-Am> yes, similar to the install guide
19:16:38 <Sam-I-Am> but probably a bit easier to coordinate among projects
19:16:54 <Sam-I-Am> mailing list if definitely your best shot
19:17:09 <strigazi> ok
19:17:16 <ShillaSaebi> +1
19:17:39 <Sam-I-Am> i know anne is looking for more people willing to try it
19:17:41 <ShillaSaebi> #topic Speciality teams
19:17:44 <ShillaSaebi> #link https://etherpad.openstack.org/p/Speciality_Team_Reports
19:17:51 <ShillaSaebi> check out the reports from last week
19:17:53 <ShillaSaebi> for updates on whats going on
19:18:47 <strigazi> cool, thanks
19:20:03 <strigazi> I'm writing magnum's install-guide as it's described in the recent spec
19:20:10 <strigazi> Additionally
19:20:11 <Sam-I-Am> hows it working?
19:20:20 <strigazi> I'm adding a guide from source
19:20:49 <strigazi> https://review.openstack.org/#/c/319399/
19:21:12 <strigazi> If you have time, have a look
19:21:35 <ShillaSaebi> cool, ill take a look
19:21:38 <ShillaSaebi> thanks strigazi
19:21:52 <Sam-I-Am> oh, virtualenvs, thats cool.
19:22:18 <Sam-I-Am> hopefully the other projects do something similar
19:22:19 <strigazi> And I added init scripts and systemd units
19:22:32 <strigazi> in an examples dir
19:22:34 <Sam-I-Am> yeah, thats also cool. i think we need templates for those sorts of things.
19:22:53 <strigazi> There is an install guide cookiecutter template
19:23:08 <strigazi> but for packaged installations
19:23:22 <Sam-I-Am> more source = better
19:23:28 <Sam-I-Am> especially since most projects dont have packages
19:23:49 <Sam-I-Am> i've always wanted the install guide to support source, but it is more steps that go outside of most people's comfort zones
19:23:56 <Sam-I-Am> most new users arent devs
19:24:23 <strigazi> Even if there are packages many people build their own
19:24:36 <Sam-I-Am> yeah
19:24:50 <strigazi> ok, I don't know if they are many, but we do
19:26:37 <strigazi> For the old install-guide, now moved, I think I'll finish it this or next week
19:26:57 <strigazi> It took me some time
19:27:49 <Sam-I-Am> ok
19:29:06 <Sam-I-Am> ShillaSaebi: anything else?
19:29:07 <ShillaSaebi> cool
19:29:10 <ShillaSaebi> thanks strigazi
19:29:22 <ShillaSaebi> #info Install Guide: meeting has been rebooted: http://eavesdrop.openstack.org/#Documentation_Install_Team_Meeting
19:29:52 <ShillaSaebi> #topic Countdown to release: #link http://www.timeanddate.com/countdown/launch?iso=20161006T00&p0=1440&msg=OpenStack+Newton+Launch+Date&font=slab
19:30:12 <ShillaSaebi> and the Newton deliverables are accessible via this #link https://wiki.openstack.org/wiki/Documentation/NewtonDeliverables
19:30:19 <ShillaSaebi> thats really all I got for today
19:30:30 <ShillaSaebi> #topic open discussion
19:30:37 <ShillaSaebi> anyone have anything they want to bring up?
19:30:53 <strigazi> I'm good
19:31:06 <ShillaSaebi> ok
19:31:11 <ShillaSaebi> thank you all for joining
19:31:15 <ShillaSaebi> have a great rest of the week
19:31:22 <ShillaSaebi> see you all in 2 weeks hopefully
19:31:24 <ShillaSaebi> #endmeeting