DEVELOPERS.txt

==================
DEVELOPING WEBLOGO
==================


---------------------------------------------
 Procedure to Build and Release new versions 
---------------------------------------------

1. Make sure local repository is up to date.
	
	The WebLogo repository is https://github.com/WebLogo/weblogo

2.  Update version number if necessary (corebio/_version.py )


3. 	Update changelog (weblogolib/htdocs/weblogo_changelog.txt)


4. 	Update manual.html with the latest --help text.


5. 	Rebuild examples. (./build.sh)
		
	
6. 	Run build process under all supported python versions.
	
	sudo port select python python27	# MacPorts on OS X
	./build.sh


7. 	Run webpage tests.

	./weblogo --serve	# then goto localhost:8080/test.html and try tests


8.  Commit final changes.


9.  Branch

	git branch 3.x
	git checkout 3.x


10. Tag
	tag release on Github at https://github.com/WebLogo/weblogo/releases/new	


11. Update server: login to weblogo.threeplusone.com, weblogo directory and switch branches 
	
	git checkout 3.x


12. Check server is working correctly. Run tests at weblogo.threeplusone.com/tests.html


13. Register with Python Packakge Index PyPI
	
	python setup.py sdist upload	# Assumes already regitered with PyPI
	pip install weblogo
 	
	(Should try this all out on the test PyPI test site)
	python setup.py register -r https://testpypi.python.org/pypi
	python setup.py sdist upload -r https://testpypi.python.org/pypi
	pip install --install-option="--install-scripts=~/" -i https://testpypi.python.org/pypi weblogo
	

14. Update version number in trunk, add new entry to changelog,

15. Post announcement. (http://groups.google.com/group/WebLogo)