February 2013 - Release-team - mailman3.cels.anl.gov

prizes for this week
by Thomas Brettin 03 Feb '13

03 Feb '13

Elizabeth was so kind as to pony up some prizes on behalf of outreach for this build :-) Here is what we came up with for categories-- The module that has the best test coverage of their service as determined by Miriam > Prize: Chewbacca MimoMicro USB Drive & Reader Best technical API documentation as determined by Nomi > Star Wars X-Wing Ice Cube Tray Best command line user documentation as determined by Paramvir > Doctor Who Dalek Tumbler Tom

1 0

Re: [Release-team] Build week team assignments
by Nomi Harris 03 Feb '13

03 Feb '13

Great! Paramvir is a good choice. Is there anyone else we can put on tutorials? We don't have many people on that team. Nomi On Feb 3, 2013, at 4:07 AM, Thomas Brettin <brettin(a)mcs.anl.gov> wrote: > I asked Paramvir and Dylan. Paramvir > > Tom > > > On Feb 3, 2013, at 1:15 AM, Nomi Harris <nlharris(a)lbl.gov> wrote: > >> >> On Feb 2, 2013, at 7:55 AM, "Land, Miriam L." <landml(a)ornl.gov> wrote: >> >>> Fine by me. I emailed my group yesterday. >>> >>> Who is the lead on GUI Testing? >> >> Good question. I was going to nominate Shiran, but he's not on that team. But maybe we should pick him anyway. Can you think of anyone else who would be good? >> >> Nomi >> >>> >>> Miriam >>> >>> From: Nomi Harris <nlharris(a)lbl.gov<mailto:[email protected]>> >>> Date: Friday, February 1, 2013 3:37 PM >>> To: "release-team(a)lists.kbase.us<mailto:[email protected]>" <release-team(a)lists.kbase.us<mailto:[email protected]>> >>> Subject: Re: [Release-team] Build week team assignments >>> >>> Is everyone happy with the team assignments on https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… ? >>> Nomi >>> >>> On Jan 30, 2013, at 8:58 PM, Nomi Harris <nlharris(a)lbl.gov<mailto:[email protected]>> wrote: >>> >>> Tom and I made some semi-arbitrary new assignments to teams (which included making up some new teams, such as GUI testing). Please look at https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… when you get a chance and comment on (or just change) any assignments you don't like. >>> Nomi Harris >>> Project Manager, KBase

1 0

Re: [Release-team] Build week team assignments
by Thomas Brettin 03 Feb '13

03 Feb '13

I asked Paramvir and Dylan. Paramvir Tom On Feb 3, 2013, at 1:15 AM, Nomi Harris <nlharris(a)lbl.gov> wrote: > > On Feb 2, 2013, at 7:55 AM, "Land, Miriam L." <landml(a)ornl.gov> wrote: > >> Fine by me. I emailed my group yesterday. >> >> Who is the lead on GUI Testing? > > Good question. I was going to nominate Shiran, but he's not on that team. But maybe we should pick him anyway. Can you think of anyone else who would be good? > > Nomi > >> >> Miriam >> >> From: Nomi Harris <nlharris(a)lbl.gov<mailto:[email protected]>> >> Date: Friday, February 1, 2013 3:37 PM >> To: "release-team(a)lists.kbase.us<mailto:[email protected]>" <release-team(a)lists.kbase.us<mailto:[email protected]>> >> Subject: Re: [Release-team] Build week team assignments >> >> Is everyone happy with the team assignments on https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… ? >> Nomi >> >> On Jan 30, 2013, at 8:58 PM, Nomi Harris <nlharris(a)lbl.gov<mailto:[email protected]>> wrote: >> >> Tom and I made some semi-arbitrary new assignments to teams (which included making up some new teams, such as GUI testing). Please look at https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… when you get a chance and comment on (or just change) any assignments you don't like. >> Nomi Harris >> Project Manager, KBase >> >> > > _______________________________________________ > Release-team mailing list > Release-team(a)lists.kbase.us > https://lists.kbase.us/mailman/listinfo/release-team Thomas Brettin 865-603-7760 (cell) brettin(a)mcs.anl.gov

1 0

Re: [Release-team] Build week team assignments
by Nomi Harris 03 Feb '13

03 Feb '13

On Feb 2, 2013, at 7:55 AM, "Land, Miriam L." <landml(a)ornl.gov> wrote: > Fine by me. I emailed my group yesterday. > > Who is the lead on GUI Testing? Good question. I was going to nominate Shiran, but he's not on that team. But maybe we should pick him anyway. Can you think of anyone else who would be good? Nomi > > Miriam > > From: Nomi Harris <nlharris(a)lbl.gov<mailto:[email protected]>> > Date: Friday, February 1, 2013 3:37 PM > To: "release-team(a)lists.kbase.us<mailto:[email protected]>" <release-team(a)lists.kbase.us<mailto:[email protected]>> > Subject: Re: [Release-team] Build week team assignments > > Is everyone happy with the team assignments on https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… ? > Nomi > > On Jan 30, 2013, at 8:58 PM, Nomi Harris <nlharris(a)lbl.gov<mailto:[email protected]>> wrote: > > Tom and I made some semi-arbitrary new assignments to teams (which included making up some new teams, such as GUI testing). Please look at https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… when you get a chance and comment on (or just change) any assignments you don't like. > Nomi Harris > Project Manager, KBase > >

1 0

Re: [Release-team] Build week team assignments
by Land, Miriam L. 02 Feb '13

02 Feb '13

Fine by me. I emailed my group yesterday. Who is the lead on GUI Testing? Miriam From: Nomi Harris <nlharris(a)lbl.gov<mailto:[email protected]>> Date: Friday, February 1, 2013 3:37 PM To: "release-team(a)lists.kbase.us<mailto:[email protected]>" <release-team(a)lists.kbase.us<mailto:[email protected]>> Subject: Re: [Release-team] Build week team assignments Is everyone happy with the team assignments on https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… ? Nomi On Jan 30, 2013, at 8:58 PM, Nomi Harris <nlharris(a)lbl.gov<mailto:[email protected]>> wrote: Tom and I made some semi-arbitrary new assignments to teams (which included making up some new teams, such as GUI testing). Please look at https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… when you get a chance and comment on (or just change) any assignments you don't like. Nomi Harris Project Manager, KBase

1 0

Re: [Release-team] Build week team assignments
by Nomi Harris 01 Feb '13

01 Feb '13

Is everyone happy with the team assignments on https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… ? Nomi On Jan 30, 2013, at 8:58 PM, Nomi Harris <nlharris(a)lbl.gov> wrote: > Tom and I made some semi-arbitrary new assignments to teams (which included making up some new teams, such as GUI testing). Please look at https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dHF4Nlho… when you get a chance and comment on (or just change) any assignments you don't like. > Nomi Harris > Project Manager, KBase >

1 0

Re: [Release-team] Adding columns to services spreadsheet
by Land, Miriam L. 01 Feb '13

01 Feb '13

A more stable place would be to put it in the Master tab. I copied and pasted from the git repo yesterday but the descriptions were weak. Miriam On 2/1/13 9:39 AM, "Thomas Brettin" <brettin(a)mcs.anl.gov> wrote: >Hi Elizabeth, > >I'm building the list of modules for attempted release next week. I got a >one sentence to paragraph size description of the service from a lot of >the module owners. I'm just pasting those into the kbase services spread >sheet "Feb 4 Major' tab. Take what ever you want. We can reorganize later. > >Tom >On Jan 31, 2013, at 11:49 AM, Elizabeth M. Glass <marland(a)mcs.anl.gov> >wrote: > >> Can we also add in a column on what science domains these services work >>for? M, MC, P >> >> Elizabeth >> >> ----- Original Message ----- >> From: Thomas Brettin <brettin(a)mcs.anl.gov> >> To: Miriam L. Land <landml(a)ornl.gov> >> Cc: release-team(a)lists.kbase.us, Nomi Harris <nlharris(a)lbl.gov> >> Sent: Thu, 31 Jan 2013 07:09:21 -0600 (CST) >> Subject: Re: [Release-team] Adding columns to services spreadsheet >> >> I want to keep all tabs. I plan to mine this data for research on the >>progression of the development of a release infrastructure. >> >> Tom >> >> On Jan 31, 2013, at 7:05 AM, "Land, Miriam L." <landml(a)ornl.gov> wrote: >> >>> I'm in favor of a master tab. It would be very useful when I need to >>>look >>> up something that was somewhere in an earlier build. >>> >>> I also don't have a problem deleting the tabs that came before Nov >>>Build, >>> as long as we capture information on old modules that may come up >>>again. >>> >>> I think the git repo is a great place to start parsing out the >>> descriptions. >>> >>> Until the redeploy happens this morning, I have time to get this >>>started. >>> >>> Miriam >>> >>> On 1/30/13 5:50 PM, "Nomi Harris" <nlharris(a)lbl.gov> wrote: >>> >>>> Right, I don't want to add another doc either! That's why I was >>>>asking if >>>> I could just add these two columns to the Services doc. I think >>>>they'd be >>>> useful to the people who are on the Build teams as well (maybe not so >>>> much to the people on the release team, since we already pretty much >>>>know >>>> the info that will be in those columns). >>>> I'm ok with either adding it to the Feb tab or making a new "master" >>>>tab. >>>> Nomi Harris >>>> Project Manager, KBase >>>> >>>> On Jan 30, 2013, at 1:33 PM, Dan Olson <dolson(a)mcs.anl.gov> wrote: >>>> >>>>> I'm all for adding a "master" tab to the services spreadsheet with >>>>>the >>>>> static information that doesn't change every release. >>>>> >>>>> I really don't want to add another doc - right now we have - >>>>> A punch list doc >>>>> An email template doc >>>>> A trac wiki page >>>>> A services spreadsheet >>>>> >>>>> As time goes on the more info repositories we have the more >>>>>opportunity >>>>> for them >>>>> to diverge and confusion to occur. >>>>> >>>>> ----- Original Message ----- >>>>>> From: "Miriam L. Land" <landml(a)ornl.gov> >>>>>> To: "Nomi Harris" <nlharris(a)lbl.gov>, release-team(a)lists.kbase.us >>>>>> Sent: Wednesday, January 30, 2013 3:25:48 PM >>>>>> Subject: Re: [Release-team] Adding columns to services spreadsheet >>>>>> >>>>>> Would it make sense to put the common name, repo name, contact(s), >>>>>> and >>>>>> description in a doc by itself? It could be cumulative across all >>>>>> releases. >>>>>> >>>>>> Miriam >>>>>> >>>>>> On 1/30/13 3:39 PM, "Nomi Harris" <nlharris(a)lbl.gov> wrote: >>>>>> >>>>>>> Today I talked to Elizabeth, who is starting to work on materials >>>>>>> for the >>>>>>> User Zone on the website, which will include tutorials, a new User >>>>>>> Guide, >>>>>>> and more. She is also helping to write the text about the >>>>>>>individual >>>>>>> services that is currently on >>>>>>> http://www.kbase.us/developer-zone/services/ . >>>>>>> Elizabeth asked me for two pieces of information for each service: >>>>>>> the >>>>>>> git repo name and corresponding "human language" name of each >>>>>>> service >>>>>>> (for example, Central Store Service is in the kb_seed repo--you'd >>>>>>> never >>>>>>> guess that if you didn't already know), and also whether the >>>>>>>service >>>>>>> is >>>>>>> internal-only or user-facing. I think this information would be >>>>>>> useful to >>>>>>> have on the Services spreadsheet (in fact, that spreadsheet used to >>>>>>> have >>>>>>> the human and git repo names for each service, but lost that at >>>>>>>some >>>>>>> point), but it already has a lot of columns, so I'd like permission >>>>>>> to >>>>>>> add those two. >>>>>>> The Feb 4 Major tab >>>>>>> >>>>>>> >>>>>>>(https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2 >>>>>>>dFp >>>>>>> paE >>>>>>> JzOUdfMV8zN0Y3Vm5YM095aWc#gid=14) is empty so far, so maybe we can >>>>>>> start >>>>>>> from scratch and think about what columns make sense. There were >>>>>>> some on >>>>>>> the previous tabs that we probably don't need anymore. >>>>>>> Thanks, >>>>>>> Nomi Harris >>>>>>> Project Manager, KBase >>>>>>> >>>>>>> _______________________________________________ >>>>>>> Release-team mailing list >>>>>>> Release-team(a)lists.kbase.us >>>>>>> https://lists.kbase.us/mailman/listinfo/release-team >>>>>> >>>>>> _______________________________________________ >>>>>> Release-team mailing list >>>>>> Release-team(a)lists.kbase.us >>>>>> https://lists.kbase.us/mailman/listinfo/release-team >>>>>> >>>> >>>> _______________________________________________ >>>> Release-team mailing list >>>> Release-team(a)lists.kbase.us >>>> https://lists.kbase.us/mailman/listinfo/release-team >>> >>> _______________________________________________ >>> Release-team mailing list >>> Release-team(a)lists.kbase.us >>> https://lists.kbase.us/mailman/listinfo/release-team >> >> Thomas Brettin >> 865-603-7760 (cell) >> brettin(a)mcs.anl.gov >> >> >> >> _______________________________________________ >> Release-team mailing list >> Release-team(a)lists.kbase.us >> https://lists.kbase.us/mailman/listinfo/release-team >> > >Thomas Brettin >865-603-7760 (cell) >brettin(a)mcs.anl.gov > > >

1 0

Re: [Release-team] Adding columns to services spreadsheet
by Thomas Brettin 01 Feb '13

01 Feb '13

Hi Elizabeth, I'm building the list of modules for attempted release next week. I got a one sentence to paragraph size description of the service from a lot of the module owners. I'm just pasting those into the kbase services spread sheet "Feb 4 Major' tab. Take what ever you want. We can reorganize later. Tom On Jan 31, 2013, at 11:49 AM, Elizabeth M. Glass <marland(a)mcs.anl.gov> wrote: > Can we also add in a column on what science domains these services work for? M, MC, P > > Elizabeth > > ----- Original Message ----- > From: Thomas Brettin <brettin(a)mcs.anl.gov> > To: Miriam L. Land <landml(a)ornl.gov> > Cc: release-team(a)lists.kbase.us, Nomi Harris <nlharris(a)lbl.gov> > Sent: Thu, 31 Jan 2013 07:09:21 -0600 (CST) > Subject: Re: [Release-team] Adding columns to services spreadsheet > > I want to keep all tabs. I plan to mine this data for research on the progression of the development of a release infrastructure. > > Tom > > On Jan 31, 2013, at 7:05 AM, "Land, Miriam L." <landml(a)ornl.gov> wrote: > >> I'm in favor of a master tab. It would be very useful when I need to look >> up something that was somewhere in an earlier build. >> >> I also don't have a problem deleting the tabs that came before Nov Build, >> as long as we capture information on old modules that may come up again. >> >> I think the git repo is a great place to start parsing out the >> descriptions. >> >> Until the redeploy happens this morning, I have time to get this started. >> >> Miriam >> >> On 1/30/13 5:50 PM, "Nomi Harris" <nlharris(a)lbl.gov> wrote: >> >>> Right, I don't want to add another doc either! That's why I was asking if >>> I could just add these two columns to the Services doc. I think they'd be >>> useful to the people who are on the Build teams as well (maybe not so >>> much to the people on the release team, since we already pretty much know >>> the info that will be in those columns). >>> I'm ok with either adding it to the Feb tab or making a new "master" tab. >>> Nomi Harris >>> Project Manager, KBase >>> >>> On Jan 30, 2013, at 1:33 PM, Dan Olson <dolson(a)mcs.anl.gov> wrote: >>> >>>> I'm all for adding a "master" tab to the services spreadsheet with the >>>> static information that doesn't change every release. >>>> >>>> I really don't want to add another doc - right now we have - >>>> A punch list doc >>>> An email template doc >>>> A trac wiki page >>>> A services spreadsheet >>>> >>>> As time goes on the more info repositories we have the more opportunity >>>> for them >>>> to diverge and confusion to occur. >>>> >>>> ----- Original Message ----- >>>>> From: "Miriam L. Land" <landml(a)ornl.gov> >>>>> To: "Nomi Harris" <nlharris(a)lbl.gov>, release-team(a)lists.kbase.us >>>>> Sent: Wednesday, January 30, 2013 3:25:48 PM >>>>> Subject: Re: [Release-team] Adding columns to services spreadsheet >>>>> >>>>> Would it make sense to put the common name, repo name, contact(s), >>>>> and >>>>> description in a doc by itself? It could be cumulative across all >>>>> releases. >>>>> >>>>> Miriam >>>>> >>>>> On 1/30/13 3:39 PM, "Nomi Harris" <nlharris(a)lbl.gov> wrote: >>>>> >>>>>> Today I talked to Elizabeth, who is starting to work on materials >>>>>> for the >>>>>> User Zone on the website, which will include tutorials, a new User >>>>>> Guide, >>>>>> and more. She is also helping to write the text about the individual >>>>>> services that is currently on >>>>>> http://www.kbase.us/developer-zone/services/ . >>>>>> Elizabeth asked me for two pieces of information for each service: >>>>>> the >>>>>> git repo name and corresponding "human language" name of each >>>>>> service >>>>>> (for example, Central Store Service is in the kb_seed repo--you'd >>>>>> never >>>>>> guess that if you didn't already know), and also whether the service >>>>>> is >>>>>> internal-only or user-facing. I think this information would be >>>>>> useful to >>>>>> have on the Services spreadsheet (in fact, that spreadsheet used to >>>>>> have >>>>>> the human and git repo names for each service, but lost that at some >>>>>> point), but it already has a lot of columns, so I'd like permission >>>>>> to >>>>>> add those two. >>>>>> The Feb 4 Major tab >>>>>> >>>>>> (https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2dFp >>>>>> paE >>>>>> JzOUdfMV8zN0Y3Vm5YM095aWc#gid=14) is empty so far, so maybe we can >>>>>> start >>>>>> from scratch and think about what columns make sense. There were >>>>>> some on >>>>>> the previous tabs that we probably don't need anymore. >>>>>> Thanks, >>>>>> Nomi Harris >>>>>> Project Manager, KBase >>>>>> >>>>>> _______________________________________________ >>>>>> Release-team mailing list >>>>>> Release-team(a)lists.kbase.us >>>>>> https://lists.kbase.us/mailman/listinfo/release-team >>>>> >>>>> _______________________________________________ >>>>> Release-team mailing list >>>>> Release-team(a)lists.kbase.us >>>>> https://lists.kbase.us/mailman/listinfo/release-team >>>>> >>> >>> _______________________________________________ >>> Release-team mailing list >>> Release-team(a)lists.kbase.us >>> https://lists.kbase.us/mailman/listinfo/release-team >> >> _______________________________________________ >> Release-team mailing list >> Release-team(a)lists.kbase.us >> https://lists.kbase.us/mailman/listinfo/release-team > > Thomas Brettin > 865-603-7760 (cell) > brettin(a)mcs.anl.gov > > > > _______________________________________________ > Release-team mailing list > Release-team(a)lists.kbase.us > https://lists.kbase.us/mailman/listinfo/release-team > Thomas Brettin 865-603-7760 (cell) brettin(a)mcs.anl.gov

1 0

Re: [Release-team] Adding columns to services spreadsheet
by Land, Miriam L. 01 Feb '13

01 Feb '13

In my opinion, the Master tab is a good place to place information that is stable from release to release. I have added a science domain column. I noticed that the 'Module Description' from the git repo and much less informative than what we have on the web. I'm not sure if it is very useful at the moment. I do like having a place to remind ourselves what is private (unadvertised) and what is public. Miriam On 1/31/13 12:49 PM, "Elizabeth M. Glass" <marland(a)mcs.anl.gov> wrote: >Can we also add in a column on what science domains these services work >for? M, MC, P > >Elizabeth > >----- Original Message ----- >From: Thomas Brettin <brettin(a)mcs.anl.gov> >To: Miriam L. Land <landml(a)ornl.gov> >Cc: release-team(a)lists.kbase.us, Nomi Harris <nlharris(a)lbl.gov> >Sent: Thu, 31 Jan 2013 07:09:21 -0600 (CST) >Subject: Re: [Release-team] Adding columns to services spreadsheet > >I want to keep all tabs. I plan to mine this data for research on the >progression of the development of a release infrastructure. > >Tom > >On Jan 31, 2013, at 7:05 AM, "Land, Miriam L." <landml(a)ornl.gov> wrote: > >> I'm in favor of a master tab. It would be very useful when I need to >>look >> up something that was somewhere in an earlier build. >> >> I also don't have a problem deleting the tabs that came before Nov >>Build, >> as long as we capture information on old modules that may come up again. >> >> I think the git repo is a great place to start parsing out the >> descriptions. >> >> Until the redeploy happens this morning, I have time to get this >>started. >> >> Miriam >> >> On 1/30/13 5:50 PM, "Nomi Harris" <nlharris(a)lbl.gov> wrote: >> >>> Right, I don't want to add another doc either! That's why I was asking >>>if >>> I could just add these two columns to the Services doc. I think they'd >>>be >>> useful to the people who are on the Build teams as well (maybe not so >>> much to the people on the release team, since we already pretty much >>>know >>> the info that will be in those columns). >>> I'm ok with either adding it to the Feb tab or making a new "master" >>>tab. >>> Nomi Harris >>> Project Manager, KBase >>> >>> On Jan 30, 2013, at 1:33 PM, Dan Olson <dolson(a)mcs.anl.gov> wrote: >>> >>>> I'm all for adding a "master" tab to the services spreadsheet with the >>>> static information that doesn't change every release. >>>> >>>> I really don't want to add another doc - right now we have - >>>> A punch list doc >>>> An email template doc >>>> A trac wiki page >>>> A services spreadsheet >>>> >>>> As time goes on the more info repositories we have the more >>>>opportunity >>>> for them >>>> to diverge and confusion to occur. >>>> >>>> ----- Original Message ----- >>>>> From: "Miriam L. Land" <landml(a)ornl.gov> >>>>> To: "Nomi Harris" <nlharris(a)lbl.gov>, release-team(a)lists.kbase.us >>>>> Sent: Wednesday, January 30, 2013 3:25:48 PM >>>>> Subject: Re: [Release-team] Adding columns to services spreadsheet >>>>> >>>>> Would it make sense to put the common name, repo name, contact(s), >>>>> and >>>>> description in a doc by itself? It could be cumulative across all >>>>> releases. >>>>> >>>>> Miriam >>>>> >>>>> On 1/30/13 3:39 PM, "Nomi Harris" <nlharris(a)lbl.gov> wrote: >>>>> >>>>>> Today I talked to Elizabeth, who is starting to work on materials >>>>>> for the >>>>>> User Zone on the website, which will include tutorials, a new User >>>>>> Guide, >>>>>> and more. She is also helping to write the text about the individual >>>>>> services that is currently on >>>>>> http://www.kbase.us/developer-zone/services/ . >>>>>> Elizabeth asked me for two pieces of information for each service: >>>>>> the >>>>>> git repo name and corresponding "human language" name of each >>>>>> service >>>>>> (for example, Central Store Service is in the kb_seed repo--you'd >>>>>> never >>>>>> guess that if you didn't already know), and also whether the service >>>>>> is >>>>>> internal-only or user-facing. I think this information would be >>>>>> useful to >>>>>> have on the Services spreadsheet (in fact, that spreadsheet used to >>>>>> have >>>>>> the human and git repo names for each service, but lost that at some >>>>>> point), but it already has a lot of columns, so I'd like permission >>>>>> to >>>>>> add those two. >>>>>> The Feb 4 Major tab >>>>>> >>>>>> >>>>>>(https://docs.google.com/a/lbl.gov/spreadsheet/ccc?key=0Ana5oznWypH2d >>>>>>Fp >>>>>> paE >>>>>> JzOUdfMV8zN0Y3Vm5YM095aWc#gid=14) is empty so far, so maybe we can >>>>>> start >>>>>> from scratch and think about what columns make sense. There were >>>>>> some on >>>>>> the previous tabs that we probably don't need anymore. >>>>>> Thanks, >>>>>> Nomi Harris >>>>>> Project Manager, KBase >>>>>> >>>>>> _______________________________________________ >>>>>> Release-team mailing list >>>>>> Release-team(a)lists.kbase.us >>>>>> https://lists.kbase.us/mailman/listinfo/release-team >>>>> >>>>> _______________________________________________ >>>>> Release-team mailing list >>>>> Release-team(a)lists.kbase.us >>>>> https://lists.kbase.us/mailman/listinfo/release-team >>>>> >>> >>> _______________________________________________ >>> Release-team mailing list >>> Release-team(a)lists.kbase.us >>> https://lists.kbase.us/mailman/listinfo/release-team >> >> _______________________________________________ >> Release-team mailing list >> Release-team(a)lists.kbase.us >> https://lists.kbase.us/mailman/listinfo/release-team > >Thomas Brettin >865-603-7760 (cell) >brettin(a)mcs.anl.gov > > > >_______________________________________________ >Release-team mailing list >Release-team(a)lists.kbase.us >https://lists.kbase.us/mailman/listinfo/release-team >

1 0

Re: [Release-team] Where is that documentation??
by Land, Miriam L. 01 Feb '13

01 Feb '13

I have drafted a 'Standard Documents' page at: https://trac.kbase.us/projects/kbase/wiki/StandardDocuments It could probably be expanded to include what is required, but for now, it is a straw man. Miriam On 1/31/13 5:26 PM, "Nomi Harris" <nlharris(a)lbl.gov> wrote: >Thanks, Miriam, this is a much-needed reference page. Please go ahead and >set it up and then people can edit if needed. > Nomi Harris > Project Manager, KBase > >On Jan 31, 2013, at 12:46 PM, "Land, Miriam L." <landml(a)ornl.gov> wrote: > >> All, >> >> The following started with a simple question from a developer, "Where >>do I put KBase documentation?" I couldn't find a clear and concise >>answer documented anywhere and it seems that the answer depends on what >>they mean by "documentation". >> >> By poking around, I have concluded that user manuals are in the >>docs.git repo under user_manuals/<module_name> while the tutorials are >>also in the docs.git repo but under <module_name>/tutorials (flipped >>order). There are HTML files in the docs.git repo under >><module_name>/API but it is not clear if there is any relationship to >>the HTML generated out of the type spec, and >>http://kbase.us/services/docs. I can't find documentation on who is >>responsible for writing some of these files and how these get propagated >>to the web (I've overheard oral instructions but little in writing). In >>addition to the type spec and multiple locations in the docs.git repo, >>we have the release notes which are part of the module repo with no >>specific file name and service descriptions developers supply through >>email at some point. I know we are evolving and defining things as we >>go along, but wouldn't you find this confusing at first? >> >> Most developers eventually find out all this through email exchanges. >>Would anyone mind if I started a trac page that lists the mandatory >>files/information which we expect developers to produce? My first draft >>is below. >> >> Miriam >> -------------------------------------- >> Type Spec - >> >> * A controlled vocabulary for defining methods and types for a >>module. The type compiler converts this into a standard directory >>structure and stubs for necessary files. >> * Recommended naming convention is <module_name>.spec >> * >>https://trac.kbase.us/projects/kbase/attachment/wiki/API/Type_compiler.pd >>f >> >> DEPENDENCIES >> >> * A required file in the module top dir that lists dependencies >> * https://trac.kbase.us/projects/kbase/wiki/IndependentBuild >> >> deploy.cfg >> >> * Located in the module top dir and is needed for deployments >> * https://trac.kbase.us/projects/kbase/wiki/DeployCfgStandards >> >> Makefile >> >> * Located in the module top dir and is used in deployment, document >>generation, and testing >> * Example Makefile is part of the dev_container/docs/module.Makefile >> * Standard Makefile Targets - >>https://trac.kbase.us/projects/kbase/wiki/MakefileTargets >> >> Release Notes >> >> * A file in the module top dir with a name that a human would >>recognize as a release note (e.g., Release_notes_01Jan2013). >> * https://trac.kbase.us/projects/kbase/wiki/ReleaseNotesStyle >> >> Technical Documentation >> >> * information imbedded within the type spec document that describes >>methods and types. >> * The document is auto-generated when the type spec is complied and >>it is copied the /kb/deployment/services/<module_name>/webroot during >>deployment. >> * Can be accessed through http://kbase.us/services/docs/<module_name>. >> * https://trac.kbase.us/projects/kbase/wiki/DocStructures >> >> User Manual >> >> * Comprehensive documentation of methods and types. More detailed >>than technical documentation and more comprehensive that a tutorial. >> * Created from scratch and it committed to the docs.git repo under >>the user_manuals/<module_name> directory. >> * https://trac.kbase.us/projects/kbase/wiki/UserManuals >> >> Tutorials >> >> * A guided tour through a typical usage pattern for the module. >> * Created from scratch and it is committed to the docs.git repo under >><module_name>/tutorials. >> * >>https://docs.google.com/document/d/1IxUo3kSWStE6rPYWemY_RmVyPA36lYNDa9QOp >>yxPvbg/edit (note, not at trac) >> >> >> _______________________________________________ >> Release-team mailing list >> Release-team(a)lists.kbase.us >> https://lists.kbase.us/mailman/listinfo/release-team >

1 0