From: Charlie G. <cha...@gm...> - 2006-08-24 17:30:04
|
On 8/24/06, Alan Kennedy <jyt...@xh...> wrote: > [Khalid Zuberi] > > The FAQ is also duplicated in several places. The one in the wiki and the > > cgi version should be user update-able, but i doubt they are all kept > > automatically synchronized. > > > > http://www.jython.org/Project/userfaq.html > > http://wiki.python.org/jython/JythonFaq > > http://www.jython.org/cgi-bin/faqw.py?req=index > > > > I think ideally we keep just one, and make it easy for anyone to > > update directly, or at least obvious where to send additions. Possibly > > Frank is planning to keep the userfaq version up-to-date as the > > official one? I'd vote for userfaq as well. The cgi faq looks scary and unrelated to jython and I'd rather not have to patrol the wiki faq for spam. > What is the current hosting situation? Is jython.org being hosted by the > python.org people yet? It's on Sourceforge. Is there a reason to the hosting elsewhere? > Does anyone know what FAQ arrangement cpython has? Do you mean http://www.python.org/doc/faq/? We could probably do the same sort of breakdown of sections which would be nice. Charlie |
From: Alan K. <jyt...@xh...> - 2006-08-24 18:36:32
|
[Alan Kennedy] >> What is the current hosting situation? Is jython.org being hosted by >> the python.org people yet? [Charlie Groves] > It's on Sourceforge. Is there a reason to the hosting elsewhere? Sorry, I should have been clearer. There was talk a few months back about hosting jython on python.org. Or maybe that was just the Wiki and Subversion? [Alan Kennedy] >> Does anyone know what FAQ arrangement cpython has? [Charlie Groves] > Do you mean http://www.python.org/doc/faq/? We could probably do the > same sort of breakdown of sections which would be nice. Sorry, again I should have been more explicit. I meant to ask "what software and/or hosting infrastructure do the cpython people use for managing their FAQ?" I asked the question with the implicit intention of asking "can jython use the same software and/or hosting infrastructure as cpython?" As a general principle, it would be great if we could share/piggyback-on as much of the cpython infrastructure as possible. But cpython is itself continually undergoing changes; cf the current call for a new bug tracker for cpython. http://wiki.python.org/moin/CallForTrackers Regards, Alan. |
From: Frank W. <fwi...@gm...> - 2006-08-26 00:34:52
|
> Sorry, I should have been clearer. There was talk a few months back > about hosting jython on python.org. Or maybe that was just the Wiki and > Subversion? The subversion hosting fell through but they do host the Jython wiki. I haven't approached them about website hosting, though they do have a pretty nice new setup. I believe the python.org site source is at least partially in ReSTructered text and yaml. Since the Jython site is generated from ReSTructered text as well we might be able to use their infrastructure. However, I definitely don't have time to look into that. -Frank |
From: Charlie G. <cha...@gm...> - 2006-08-25 02:42:54
|
On 8/24/06, Alan Kennedy <jyt...@xh...> wrote: > [Alan Kennedy] > >> Does anyone know what FAQ arrangement cpython has? > > [Charlie Groves] > > Do you mean http://www.python.org/doc/faq/? We could probably do the > > same sort of breakdown of sections which would be nice. > > Sorry, again I should have been more explicit. > > I meant to ask "what software and/or hosting infrastructure do the > cpython people use for managing their FAQ?" > > I asked the question with the implicit intention of asking "can jython > use the same software and/or hosting infrastructure as cpython?" I see this as more of a manpower problem than an infrastructure problem. Unless the python infrastructure answers frequently asked questions without human intervention and merges duplicate faqs it won't fix this. AI is more of a Lisp kinda thing anyway :) Since no one else has piped up, I can merge the three faqs into the one on the main site and link the other two to there. I'll handle updating the faq until it gets painful and then we can get some infrastructure. Fair enough? Charlie |
From: Oti <oh...@gm...> - 2006-08-25 23:04:02
|
Hi Charlie, sure fair enough. I'm soon getting to bug 1042465, which essentially means 'not enough docs', and join in a bit. best wishes, Oti. On 8/25/06, Charlie Groves <cha...@gm...> wrote: > On 8/24/06, Alan Kennedy <jyt...@xh...> wrote: > > [Alan Kennedy] > > >> Does anyone know what FAQ arrangement cpython has? > > > > [Charlie Groves] > > > Do you mean http://www.python.org/doc/faq/? We could probably do the > > > same sort of breakdown of sections which would be nice. > > > > Sorry, again I should have been more explicit. > > > > I meant to ask "what software and/or hosting infrastructure do the > > cpython people use for managing their FAQ?" > > > > I asked the question with the implicit intention of asking "can jython > > use the same software and/or hosting infrastructure as cpython?" > > I see this as more of a manpower problem than an infrastructure > problem. Unless the python infrastructure answers frequently asked > questions without human intervention and merges duplicate faqs it > won't fix this. AI is more of a Lisp kinda thing anyway :) > > Since no one else has piped up, I can merge the three faqs into the > one on the main site and link the other two to there. I'll handle > updating the faq until it gets painful and then we can get some > infrastructure. Fair enough? |
From: Frank W. <fwi...@gm...> - 2006-08-26 00:24:18
|
> I see this as more of a manpower problem than an infrastructure > problem. Unless the python infrastructure answers frequently asked > questions without human intervention and merges duplicate faqs it > won't fix this. AI is more of a Lisp kinda thing anyway :) > > Since no one else has piped up, I can merge the three faqs into the > one on the main site and link the other two to there. I'll handle > updating the faq until it gets painful and then we can get some > infrastructure. Fair enough? Hi, sorry I'm so slow to answer lately. I see the one at http://www.jython.org/Project/userfaq.html as the "official" faq. I used a custom docutils writer to transform some ReSTructured text docs to create the website. The source docs are in subversion in "trunk/website" and the docutils stuff is under trunk/sandbox/wierzbicki/jysite. If someone wants to work on those docs I can flesh out some instructions on how to generate the docs. -Frank |
From: Oti <oh...@gm...> - 2006-08-26 05:46:33
|
On 8/26/06, Frank Wierzbicki <fwi...@gm...> wrote: > Hi, sorry I'm so slow to answer lately. I see the one at > http://www.jython.org/Project/userfaq.html as the "official" faq. I > used a custom docutils writer to transform some ReSTructured text docs > to create the website. The source docs are in subversion in > "trunk/website" and the docutils stuff is under > trunk/sandbox/wierzbicki/jysite. If someone wants to work on those > docs I can flesh out some instructions on how to generate the docs. Frank, instructions would be helpful to know. thanks! Oti. |
From: Charlie G. <cha...@gm...> - 2006-08-26 19:19:54
|
Ok, a slightly updated FAQ is up on the site. I cleaned up the http://www.jython.org/Project/userfaq.html version a bit and then checked it against the cgi-bin and wiki versions for things that were missing. I found a couple things added in the wiki version that I pulled over to userfaq.html and that's about it. I'll let this sit for a couple weeks and if it looks good to everyone I'll put a link in the cgi-bin version that userfaq.html is the new place for faq entries, and delete the stuff in the wiki and replace it with a link. If anyone has any frequently asked questioned they'd like to see answered there I'll be happy to add them. I'd prefer questions that come with answers :) I also fixed all the broken links from www.jython.org/bugs/1539970. If there are any I missed, report them here or on that bug . I ran a link checker over the site so I don't think there are any. Charlie On 8/24/06, Charlie Groves <cha...@gm...> wrote: > On 8/24/06, Alan Kennedy <jyt...@xh...> wrote: > > [Alan Kennedy] > > >> Does anyone know what FAQ arrangement cpython has? > > > > [Charlie Groves] > > > Do you mean http://www.python.org/doc/faq/? We could probably do the > > > same sort of breakdown of sections which would be nice. > > > > Sorry, again I should have been more explicit. > > > > I meant to ask "what software and/or hosting infrastructure do the > > cpython people use for managing their FAQ?" > > > > I asked the question with the implicit intention of asking "can jython > > use the same software and/or hosting infrastructure as cpython?" > > I see this as more of a manpower problem than an infrastructure > problem. Unless the python infrastructure answers frequently asked > questions without human intervention and merges duplicate faqs it > won't fix this. AI is more of a Lisp kinda thing anyway :) > > Since no one else has piped up, I can merge the three faqs into the > one on the main site and link the other two to there. I'll handle > updating the faq until it gets painful and then we can get some > infrastructure. Fair enough? > > Charlie > |
From: Frank W. <fwi...@gm...> - 2006-08-27 01:10:25
|
Hey Charlie, Since you've recently gone through the process of getting the docutils stuff working, would you mind writing up the steps you took somewhere? Since my environment has been set up for a long time I might forget a step. If you've had any problems setting it up or if you don't have time to write up the steps, I can work on getting it running in a new environment and write it up sometime this week. Thanks, -Frank |
From: Charlie G. <cha...@gm...> - 2006-08-27 17:52:27
|
Instructions are up at http://wiki.python.org/jython/JythonDeveloperGuide/WebsiteBuilderSetup I just wrote them down from memory so I could've missed a step as well, but I don't think it's anything more than that. Charlie On 8/26/06, Frank Wierzbicki <fwi...@gm...> wrote: > Hey Charlie, > > Since you've recently gone through the process of getting the docutils > stuff working, would you mind writing up the steps you took somewhere? > Since my environment has been set up for a long time I might forget a > step. If you've had any problems setting it up or if you don't have > time to write up the steps, I can work on getting it running in a new > environment and write it up sometime this week. > > Thanks, > > -Frank > |
From: Frank W. <fwi...@gm...> - 2006-08-27 19:27:22
|
On 8/27/06, Charlie Groves <cha...@gm...> wrote: > Instructions are up at > http://wiki.python.org/jython/JythonDeveloperGuide/WebsiteBuilderSetup > I just wrote them down from memory so I could've missed a step as > well, but I don't think it's anything more than that. Thanks Charile, That looks about right. For some reason I thought it was more complcated than that - I forgot that I had ant-enabled it. -Frank |