[Python-markdown-discuss] Proposed File Cleanup and reorg.

[Waylan L. <wa...@gm...>]

I just created a new branch [1] that reorganizes and (IMO) cleans up
the file system a little. All the text files are moved into a 'docs/'
dir and all the extensions have been moved into a 'mdx/' dir. It feels
so much less cluttered to me this way.

I should note that, as you can see in this commit [2], it still tries
the old way of importing the 'mdx_extname.py' first, then on failure,
'mdx.mdx_extname.py'. That way, people can create their own
extensions, give it the same name, put it on their PYTHONPATH and it
will override the distributed extension - all without them needing to
modify the distributed code. Thus, in any future upgrades, their work
won't get overwritten. Plus, those who don't actually install, but
have everything in the working dir still get the current behavior if
they want.

Anyone have any objections to either the docs or extensions move? If
there's no objections, I'll merge it in. If I get objections to only
one or the other, I can work with that too.

One other question: if we do the extension reorg, should the
extensions be 'mdx.mdx_extname.py' or 'mdx.extname.py'? It's just that
the extra 'mdx' seems redundant - but given that we've already
established that naming convention, maybe we should leave it.
Thoughts?

Oh, I added AUTHORS and INSTALL files in the docs. The INSTALL file is
vary incomplete and those sections of the README should probably be
removed.

[1]: http://gitorious.org/projects/python-markdown/repos/mainline/trees/reorg
[2]: http://gitorious.org/projects/python-markdown/repos/mainline/commits/2b7e391fcd51d3468133f628f2e013574cf16536#markdown.py
-- 
----
Waylan Limberg
wa...@gm...