Обсуждение: Google Doc Camp
All, http://www.flossmanuals.org/news/2013-doc-camp-call-proposals I think this would be a terrific opportunity for us to finally put together a really comprehensive, high-quality PostgreSQL Newbie Tutorial. I'd be willing to devote a couple days of my time to that, and contribute some of our corporate training materials. However, I can only do it if 4 other people want to do it too. The event is October 16-18, right before the GSOC Summit; if we get accepted, food & accomodations are paid for, and I can make a good case to pay for any airfare costs out of community funds. Who's up for it? -- Josh Berkus PostgreSQL Experts Inc. http://pgexperts.com
+1 for PostgreSQL tutorials that actually tutor. Is it worth trying to do a baseline general one first, or going directly to separate ones for DBAs, app & DB developers, etc.? Cheers, David. On Sat, Aug 03, 2013 at 06:45:49PM -0700, Craig Kerstiens wrote: > Count me as both intrigued and interest. > > Josh and others may know my feelings… The Postgres tutorial needs to be entirely blown up. There's a great set of referencedocs, but in terms of getting started its quite painful. I suspect with some information on what people are payingto in the existing docs, as well as various resources such as postgresguide.com (http://postgresguide.com) we couldcreate a tutorial that is not only helpful but helps compete quite well in the broader DBA/app dev ecosystem. > > ~ Craig > > > On Thursday, August 1, 2013 at 2:32 PM, Josh Berkus wrote: > > > All, > > > > http://www.flossmanuals.org/news/2013-doc-camp-call-proposals > > > > I think this would be a terrific opportunity for us to finally put > > together a really comprehensive, high-quality PostgreSQL Newbie > > Tutorial. I'd be willing to devote a couple days of my time to that, > > and contribute some of our corporate training materials. > > > > However, I can only do it if 4 other people want to do it too. > > > > The event is October 16-18, right before the GSOC Summit; if we get > > accepted, food & accomodations are paid for, and I can make a good case > > to pay for any airfare costs out of community funds. > > > > Who's up for it? > > > > -- > > Josh Berkus > > PostgreSQL Experts Inc. > > http://pgexperts.com > > > > > > > > -- David Fetter <david@fetter.org> http://fetter.org/ Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter Skype: davidfetter XMPP: david.fetter@gmail.com iCal: webcal://www.tripit.com/feed/ical/people/david74/tripit.ics Remember to vote! Consider donating to Postgres: http://www.postgresql.org/about/donate
On Aug 5, 2013, at 9:20 AM, David Fetter <david@fetter.org> wrote: > +1 for PostgreSQL tutorials that actually tutor. Is it worth trying > to do a baseline general one first, or going directly to separate ones > for DBAs, app & DB developers, etc.? For real newbies a major hurdle is getting the server up and a user / database created, so a platform-specific "actually getting up and running" prequel tutorial would also be a big improvement. And "how to connect to postgresql from $APP" (including ports, JDBC, HBA, connection URLs, …). OK, that's a fair sized project on it's own. (And I'm just down the road from Google HQ. Interesting.) Cheers, Steve > > Cheers, > David. > On Sat, Aug 03, 2013 at 06:45:49PM -0700, Craig Kerstiens wrote: >> Count me as both intrigued and interest. >> >> Josh and others may know my feelings… The Postgres tutorial needs to be entirely blown up. There's a great set of referencedocs, but in terms of getting started its quite painful. I suspect with some information on what people are payingto in the existing docs, as well as various resources such as postgresguide.com (http://postgresguide.com) we couldcreate a tutorial that is not only helpful but helps compete quite well in the broader DBA/app dev ecosystem. >> >> ~ Craig >> >> >> On Thursday, August 1, 2013 at 2:32 PM, Josh Berkus wrote: >> >>> All, >>> >>> http://www.flossmanuals.org/news/2013-doc-camp-call-proposals >>> >>> I think this would be a terrific opportunity for us to finally put >>> together a really comprehensive, high-quality PostgreSQL Newbie >>> Tutorial. I'd be willing to devote a couple days of my time to that, >>> and contribute some of our corporate training materials. >>> >>> However, I can only do it if 4 other people want to do it too. >>> >>> The event is October 16-18, right before the GSOC Summit; if we get >>> accepted, food & accomodations are paid for, and I can make a good case >>> to pay for any airfare costs out of community funds. >>> >>> Who's up for it? >>> >>> -- >>> Josh Berkus >>> PostgreSQL Experts Inc. >>> http://pgexperts.com >>> >>> >>> >> >> > > -- > David Fetter <david@fetter.org> http://fetter.org/ > Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter > Skype: davidfetter XMPP: david.fetter@gmail.com > iCal: webcal://www.tripit.com/feed/ical/people/david74/tripit.ics > > Remember to vote! > Consider donating to Postgres: http://www.postgresql.org/about/donate > > > -- > Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) > To make changes to your subscription: > http://www.postgresql.org/mailpref/pgsql-docs
On Mon, 2013-08-05 at 09:41 -0700, Steve Atkins wrote: > For real newbies a major hurdle is getting the server up and > a user / database created, so a platform-specific "actually getting > up and running" prequel tutorial would also be a big improvement. > I agree. The real gap we have are platform-specific getting-started tutorials. All the tricky initial steps are very platform specific. These tutorials could be put into the wiki initially.
On Aug 5, 2013, at 1:10 PM, Peter Eisentraut <peter_e@gmx.net> wrote: > On Mon, 2013-08-05 at 09:41 -0700, Steve Atkins wrote: >> For real newbies a major hurdle is getting the server up and >> a user / database created, so a platform-specific "actually getting >> up and running" prequel tutorial would also be a big improvement. >> > I agree. The real gap we have are platform-specific getting-started > tutorials. All the tricky initial steps are very platform specific. > > These tutorials could be put into the wiki initially. I started. https://wiki.postgresql.org/wiki/Opinionated_OS_X What I'd really like to see would be some Windows-specific stuff (as the Windows-newbies seem to be way more confused than anyone else and I don't think it's their fault). Cheers, Steve
On 08/03/2013 06:45 PM, Craig Kerstiens wrote: > Count me as both intrigued and interest. > > Josh and others may know my feelings… The Postgres tutorial needs to be entirely blown up. There's a great set of referencedocs, but in terms of getting started its quite painful. I suspect with some information on what people are payingto in the existing docs, as well as various resources such as postgresguide.com (http://postgresguide.com) we couldcreate a tutorial that is not only helpful but helps compete quite well in the broader DBA/app dev ecosystem. Actually, on further feedback from the organizer, it's not 2 days, it's *five*. I don't know too many of us who can afford a full week to work on community documentation. Oh well, we'll have to do it on our own :-( -- Josh Berkus PostgreSQL Experts Inc. http://pgexperts.com
Count me as both intrigued and interest.
Josh and others may know my feelings… The Postgres tutorial needs to be entirely blown up. There's a great set of reference docs, but in terms of getting started its quite painful. I suspect with some information on what people are paying to in the existing docs, as well as various resources such as postgresguide.com we could create a tutorial that is not only helpful but helps compete quite well in the broader DBA/app dev ecosystem.
~ Craig
On Thursday, August 1, 2013 at 2:32 PM, Josh Berkus wrote:
All,I think this would be a terrific opportunity for us to finally puttogether a really comprehensive, high-quality PostgreSQL NewbieTutorial. I'd be willing to devote a couple days of my time to that,and contribute some of our corporate training materials.However, I can only do it if 4 other people want to do it too.The event is October 16-18, right before the GSOC Summit; if we getaccepted, food & accomodations are paid for, and I can make a good caseto pay for any airfare costs out of community funds.Who's up for it?--Josh BerkusPostgreSQL Experts Inc.
Josh Berkus <josh@agliodbs.com> writes:
> Actually, on further feedback from the organizer, it's not 2 days, it's
> *five*. I don't know too many of us who can afford a full week to work
> on community documentation. Oh well, we'll have to do it on our own :-(
Do they insist on people showing up for the full five days?
regards, tom lane
(2013/08/06 5:15), Steve Atkins wrote: > On Aug 5, 2013, at 1:10 PM, Peter Eisentraut <peter_e@gmx.net> wrote: > >> On Mon, 2013-08-05 at 09:41 -0700, Steve Atkins wrote: >>> For real newbies a major hurdle is getting the server up and >>> a user / database created, so a platform-specific "actually getting >>> up and running" prequel tutorial would also be a big improvement. >>> >> I agree. The real gap we have are platform-specific getting-started >> tutorials. All the tricky initial steps are very platform specific. >> >> These tutorials could be put into the wiki initially. > > I started. https://wiki.postgresql.org/wiki/Opinionated_OS_X > > What I'd really like to see would be some Windows-specific > stuff (as the Windows-newbies seem to be way more confused > than anyone else and I don't think it's their fault). I have a Windows tutorial, which is based on the EDB One-click installer. http://www.uptime.jp/ja/wp-content/uploads/2012/09/Installing_PostgreSQL_9_2_on_Windows.pdf This is a step-by-step guide, from downloading a binary to connecting PostgreSQL from PHP, with lots of screenshots. This is written in Japanese so far, but I guess I can translate and contribute it if someone can review my English. Regards, -- Satoshi Nagayasu <snaga@uptime.jp> Uptime Technologies, LLC. http://www.uptime.jp
On Aug 3, 2013, at 18:45, Craig Kerstiens <craig@heroku.com> wrote: > There's a great set of reference docs, but in terms of getting started its quite painful. Yes, I can speak from experience that getting started with Postgres is definitely the biggest obstacle to its adoption. ThePostgres docs don't help enough. Even the reference doc, as excellent as it is, fails to document all the options facedby a newbie in the "New Database" dialog/wizard in the pgAdmin app. The commercial book publishers offer nothing fornewbies, at least not anything updated for later generations of Postgres. I could not find much useful material on theweb for getting started. Frankly, I would have given up on trying Postgres had it not been for the friendly folks at arecently founded local Postgres user group (Seattle). --| About BookSprints |---- These flossmanuals.org folks seem to have worked out a methodology for a very intensive process to produce an _entire_ book.This not a casual get-together to talk about working on a few chunks of material. They call it a BookSprint, like acode sprint. A facilitator has been assigned (Adam Hyde). -- A sprint brings together a group of writers, editors, and perhaps an artist and production specialist, to go from outlineto published book in five days. -- I can see that a focused multi-day in-person collaborative effort with an experienced facilitator might be vastly more productivethan a weak effort distributed over space and time. Having Google provide space and food makes for an exceptionalopportunity. --| About Me |---- I would be glad to contribute to the Postgres project by committing to the full 5 days of this Doc Camp. I'm not a Postgres expert, just an infrequent user over the last 3-4 years. I expect to become a full-time Postgres user,but my recent projects did not go that direction. I've attended most monthly meetings of our local user group, andI attended the PostgreSQL Conference West 2010. I've done a couple of evangelizing "Intro to Postgres" presentations ata different user group. I'm an old-hand at relational databases (4D.com) building database-backed apps for client companyworkgroups and departments. But I am relatively new to SQL. In a past life, I was a technical writer at a large proprietary software company. I later spent a couple years teaching apair of week-long seminars, one for novice database programmers and another advanced one for professionals. So I am skilledat technical writing and instructional design. And I'm willing to do much of the scutwork, such as typing and copy-editing.I have an eagle-eye for detail in writing. --| Going Forward |---- Unfortunately, the "2013 Doc Camp Call for Proposals" had a due date of August 7, three days ago. Perhaps if we organizequickly, we can still slip in under the wire. http://www.flossmanuals.org/news/2013-doc-camp-call-proposals Looks like they are aiming for 4-5 individuals per team. I'm not clear on this, but it seems we might pick up individualsduring the first part (2-day Unconference) who may not already be committed to a project. Nevertheless, I believewe should apply only if we have multiple people willing to commit now. Anyone else interested or willing to commit? --Basil Bourque
UPDATE: I just made contact with the coordinator of the "2013 Doc Camp Call for Proposals". • We just missed the August 7 deadline. Can we still sneak in? --> Yes, if we hurry. • Do they insist on people showing up for the full five days? --> Yes, you must commit to all 5 days. (October 14-18, 2013) The first two days discuss doc strategies, and has proven very valuable to the teams. • Might we pick up individual volunteers at the event? --> Yes. They have two types of application, Individual and Project. The individuals may "shop around" to volunteer with any of thedeclared projects. • How many people? --> We may nominate up to 5 people. • Cost? --> Accommodation and food costs - Free. --> Travel - Part or complete travel costs may be covered, as requested in our application. Also, Josh Berkus said on thisthread that community funds may be able to cover airfare costs. • When? --> Five days: October 14-18, 2013 (Monday-Friday) • Where? --> Google's Mountain View headquarters in California. • More info? --> http://www.flossmanuals.org/news/2013-doc-camp-call-proposals I'm very excited by this opportunity to make a breakthrough on some newbie/introduction/orientation/installation doc. I mighteven go it alone, but the synergy and productivity would be so much greater with at least one or two other team members. I am willing to coordinate the team and write the proposal (answer a series of questions given to me by the Doc Camp coordinator),unless Josh Berkus or someone else wants to lead the way. --Basil Bourque
On 08/11/2013 12:04 PM, Craig Kerstiens wrote: > Don't want to put too much pressure on others, but if interested I'm pretty sure I could be available the full week, andwould be happy to commit the time. Yeah, the problem is that they want 3-5 community members who can commit. And we've missed the deadline now. -- Josh Berkus PostgreSQL Experts Inc. http://pgexperts.com
Don't want to put too much pressure on others, but if interested I'm pretty sure I could be available the full week, and would be happy to commit the time.
~ Craig
On Sunday, August 11, 2013 at 12:02 PM, Josh Berkus wrote:
On 08/09/2013 07:31 PM, Tom Lane wrote:Josh Berkus <josh@agliodbs.com> writes:Actually, on further feedback from the organizer, it's not 2 days, it's*five*. I don't know too many of us who can afford a full week to workon community documentation. Oh well, we'll have to do it on our own :-(Do they insist on people showing up for the full five days?Yes. Not clear on who can afford to do this ...--Josh BerkusPostgreSQL Experts Inc.
On 08/09/2013 07:31 PM, Tom Lane wrote: > Josh Berkus <josh@agliodbs.com> writes: >> Actually, on further feedback from the organizer, it's not 2 days, it's >> *five*. I don't know too many of us who can afford a full week to work >> on community documentation. Oh well, we'll have to do it on our own :-( > > Do they insist on people showing up for the full five days? Yes. Not clear on who can afford to do this ... -- Josh Berkus PostgreSQL Experts Inc. http://pgexperts.com