On 1/26/06, Robey Pointer [EMAIL PROTECTED] wrote:
[quoting /F]
moving all of (or parts of) the reference documentation in to the
library source code would be an alternative, of course [1], but that
would basically mean starting over from scratch.
Bad idea. Putting the full docs in the
Robey Pointer wrote:
On 30 Dec 2005, at 18:29, Christopher Armstrong wrote:
[epydoc] is not really even good enough for a lot of my usage without some
seriously evil hacks. The fundamental design decision of epydoc to
import code, plus some other design decisions on the way it figures
types
On 29 Dec 2005, at 23:13, Fredrik Lundh wrote:
Robey Pointer wrote:
[Fredrik Lundh]
Really?
Yes, really.
Just out of curiosity (really -- not trying to jump into the flames)
why not just use epydoc? If it's good enough for 3rd-party python
libraries, isn't that just a small step from
On 30 Dec 2005, at 18:29, Christopher Armstrong wrote:
On 12/30/05, Robey Pointer [EMAIL PROTECTED] wrote:
Just out of curiosity (really -- not trying to jump into the flames)
why not just use epydoc? If it's good enough for 3rd-party python
libraries, isn't that just a small step from
Donovan Baarda wrote:
No, it's a fundamental goal: to support light-weight generation of rendered
markup directly from source code, to enable simple tools (CGI scripts, etc)
to be able to render reference documentation.
Python is run-time interpreted, but I don't think we need its
anyone knows anything about support for semantic markup ?
http://meta.wikimedia.org/wiki/Semantic_MediaWiki
not sure a full-blown RDF-in-wiki-syntax is really that optimal,
though ;-)
/F
___
Python-Dev mailing list
Python-Dev@python.org
M.-A. Lemburg wrote:
I haven't followed the thread, so many I'm repeating things.
Has anyone considered using e.g. MediaWiki (the wiki used for
Wikipedia) for Python documentation ?
I'm asking because this wiki has proven to be ideally suited
for creating complex documentation tasks and
I've put an instance of Commentary up against the full 2.4
documentation: http://pythonpaste.org/comment/python24/
It writes to a Subversion repository so you can see what the backend
data looks like: http://pythonpaste.org/comment/svn/python24/ -- not
much there yet. Obviously things like
In a message of Sat, 31 Dec 2005 15:41:50 +1000, Nick Coghlan writes:
Ian Bicking wrote:
Anyway, another even more expedient option would be setting up a
separate bug tracker (something simpler to submit to than SF) and
putting a link on the bottom of every page, maybe like:
Nick Coghlan wrote:
Anyway, another even more expedient option would be setting up a
separate bug tracker (something simpler to submit to than SF) and
putting a link on the bottom of every page, maybe like:
http://trac.python.org/trac/newticket?summary=re:+/path/to/doccomponent=docs
-- heck,
[David Goodger]
Could be. I don't see HTML+PythonDoc as a significant improvement
over LaTeX.
[Fredrik Lundh]
Really?
Yes, really.
Your reply makes it obvious that you don't understand the issues involved
here, nor how the goals address them.
(Snipping heavily below due to lack of
I've been dodging this thread because I don't really have much to add,
apart from a documentation end user point of view...
On Fri, 2005-12-30 at 09:25 +0100, Fredrik Lundh wrote:
[...]
Another goal is highly biased toward XML-style markup:
* Make it trivial to do basic rendering to
[David Goodger]
The second sentence lacks a rationale. What's wrong with --
dashes? What's silly about ``quotes''?
[Fredrik Lundh]
don't you know *anything* about typography ?
Yes, for a layman, I know plenty. I am not a typographer though.
Simply put, your list of goals provides no
I haven't followed the thread, so many I'm repeating things.
Has anyone considered using e.g. MediaWiki (the wiki used for
Wikipedia) for Python documentation ?
I'm asking because this wiki has proven to be ideally suited
for creating complex documentation tasks and offers many features
which
David Goodger wrote:
The problem is that the WORKFLOW doesn't work.
So fix the workflow. Something like Ian Bicking's Commentary system,
or something more specific to Python's docs, seems to fit the bill.
I'll just note that Commentary works on any HTML, so it doesn't matter
what the
On 12/30/05, Robey Pointer [EMAIL PROTECTED] wrote:
On 29 Dec 2005, at 18:58, David Goodger wrote:
[Fredrik Lundh]
I'm beginning to fear that I've wasted my time on a project
that nobody's interested in.
[David Goodger]
Could be. I don't see HTML+PythonDoc as a significant
Ian Bicking wrote:
Anyway, another even more expedient option would be setting up a
separate bug tracker (something simpler to submit to than SF) and
putting a link on the bottom of every page, maybe like:
http://trac.python.org/trac/newticket?summary=re:+/path/to/doccomponent=docs
--
On 12/29/05, Fredrik Lundh [EMAIL PROTECTED] wrote:
however, given that the discussion that led up to this has been dead for
almost a week,
You mean since Christmas?
I'm beginning to fear that I've wasted my time on a project
that nobody's interested in.
Could be. I don't see HTML+PythonDoc
David Goodger wrote:
however, given that the discussion that led up to this has been dead for
almost a week,
You mean since Christmas?
I'm beginning to fear that I've wasted my time on a project
that nobody's interested in.
Could be. I don't see HTML+PythonDoc as a significant
[Fredrik Lundh]
I'm beginning to fear that I've wasted my time on a project
that nobody's interested in.
[David Goodger]
Could be. I don't see HTML+PythonDoc as a significant improvement
over LaTeX.
[Fredrik Lundh]
Really?
Yes, really.
Have you read my list of goals?
Yes, and I mostly
On 29 Dec 2005, at 18:58, David Goodger wrote:
[Fredrik Lundh]
I'm beginning to fear that I've wasted my time on a project
that nobody's interested in.
[David Goodger]
Could be. I don't see HTML+PythonDoc as a significant improvement
over LaTeX.
[Fredrik Lundh]
Really?
Yes, really.
Robey Pointer wrote:
[Fredrik Lundh]
Really?
Yes, really.
Just out of curiosity (really -- not trying to jump into the flames)
why not just use epydoc? If it's good enough for 3rd-party python
libraries, isn't that just a small step from being good enough for
the builtin libraries?
22 matches
Mail list logo