summaryrefslogtreecommitdiff
path: root/docs/source/packaging.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/packaging.rst')
-rw-r--r--docs/source/packaging.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/source/packaging.rst b/docs/source/packaging.rst
index ad37166..d251c6d 100644
--- a/docs/source/packaging.rst
+++ b/docs/source/packaging.rst
@@ -28,6 +28,8 @@ steps:
included in the package created later.
* Edit README.txt and replace references to jQuery with FooBar.
This file's content will also be shown as long description on PyPi.
+ Please note that this file is written in reST markup, so that PyPi can
+ generate your project's page from it.
* If you use Mercurial, update .hgignore so it ignores:
^XStatic_FooBar.egg-info/
* Review all the stuff you did, make sure you did not forget anything, make
@@ -59,6 +61,9 @@ There are 3 names involved and you should follow these rules:
* display_name (metadata): the name as the upstream project itself spells it,
e.g. jQuery or FooBar. No spaces.
+Note: if you are not packaging original files, but modified files, then you
+must use a name that makes this fact obvious.
+
Version Numbers
---------------
As you are just repackaging another project, you should use the upstream
@@ -96,4 +101,10 @@ you can give the URLs via the locations metadata.
If you do not have a CDN for the files, just use locations = {}.
+Licensing
+---------
+You should put your XStatic-FooBar package under same license as the upstream
+FooBar package. This avoids licensing complications and is also appropriate
+because you only added a little metadata anyway.
+