For the doc sprint, todo items have been given three categories:
Todo
Provide sample code for the “Log in with …” implementations.
(The original entry is located in /tmp/tg2docs/docs/main/Auth/OpenID.rst, line 268.)
Todo
Difficulty Medium/Hard: document how to provide group/permission support when using an OpenID Authentication provider.
(The original entry is located in /tmp/tg2docs/docs/main/Auth/OpenID.rst, line 299.)
Todo
Difficulty Hard: document how to store OpenID identifiers in SQLAlchemy (i.e. add records for each new OpenID identity)
(The original entry is located in /tmp/tg2docs/docs/main/Auth/OpenID.rst, line 301.)
Todo
Add links to Beaker region (task-specific caching mechanisms) support.
(The original entry is located in /tmp/tg2docs/docs/main/Caching.rst, line 348.)
Todo
Document what the default Beaker cache setup is for TG 2.1 quickstarted projects (file-based, likely).
(The original entry is located in /tmp/tg2docs/docs/main/Caching.rst, line 349.)
Todo
Provide code-sample for use of cache within templates
(The original entry is located in /tmp/tg2docs/docs/main/Caching.rst, line 350.)
Todo
Difficulty: Medium. More doc types will be defined here when doc templates are brought online.
(The original entry is located in /tmp/tg2docs/docs/main/Contributing.rst, line 115.)
Todo
document use of isapi-wsgi with TurboGears
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/Alternate.rst, line 49.)
Todo
Difficulty: Hard. Document use of IIS with TurboGears thru a proxy.
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/Alternate.rst, line 50.)
Todo
Add section on “repeatable deployment options”
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/Alternate.rst, line 78.)
Todo
document Fedora/RHEL installation
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/Apache.rst, line 38.)
Todo
Priority high: Document setup of MySQL
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/DBServer.rst, line 157.)
Todo
Priority low: Document setup of Oracle
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/DBServer.rst, line 158.)
Todo
Priority low: Document setup of MSSQL
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/DBServer.rst, line 159.)
Todo
Priority low: Document deployment issues with SQLite
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/DBServer.rst, line 160.)
Todo
Priority medium: Document setup of MongoDB/Ming (not here)
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/DBServer.rst, line 162.)
Todo
Priority low: Document setup of CouchDB (not here)
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/DBServer.rst, line 163.)
Todo
Provide sample init script
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/Daemon.rst, line 27.)
Todo
Provide sample upstart
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/Daemon.rst, line 28.)
Todo
Provide sample supervisord config
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/Daemon.rst, line 29.)
Todo
Difficulty: Hard. Document usage of http://pypi.python.org/pypi/wsgisvc to deploy as a Win32 service
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/Daemon.rst, line 30.)
Todo
When we have the branch integrated, replace with easy_install modwsgideploy
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/ModWSGI.rst, line 130.)
Todo
verify whether this is still necessary in TurboGears 2.1
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/ProductionINI.rst, line 76.)
Todo
Document processes for repeatable local-only releases: Local PyPI, PIP, recordeggs, whole-virtualenv checkin/checkout.
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/index.rst, line 52.)
Todo
clean up the LightHTTPD + FastCGI deployment documentation
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/lighttpd+fcgi.rst, line 6.)
Todo
consolidate the 3 FastCGI documents (Mod-FastCGI, NGINX FastCGI and LightHTTPD FastCGI) as well as the Mod-Proxy stuff.
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/lighttpd+fcgi.rst, line 7.)
Todo
Need to test and document these options better if we’re going to keep them in the official documentation.
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/nginx/index.rst, line 30.)
Todo
references CherryPy, update for TG 2.1
(The original entry is located in /tmp/tg2docs/docs/main/Deployment/nginx/load_balance.rst, line 23.)
Todo
Difficulty: Easy. Make this extension more prominent, more likely to be found
(The original entry is located in /tmp/tg2docs/docs/main/Extensions/index.rst, line 18.)
Todo
Difficulty: Hard. At some point, we should also find a way to document how to handle Horizontal and Vertical Partitioning properly, and document that in here, too.
(The original entry is located in /tmp/tg2docs/docs/main/MultipleDatabases.rst, line 174.)
Todo
Difficulty: Medium to Hard. This is an empty file. We need to discuss this topic in depth.
(The original entry is located in /tmp/tg2docs/docs/main/Performance/TemplatePerformance.rst, line 5.)
Todo
Difficulty: Easy. previous paragraph referenced “widget browser” and “toolbox” as links. These do not exist for tg2. Need to add them back in here when they are eventually re-written.
(The original entry is located in /tmp/tg2docs/docs/main/SimpleWidgetForm.rst, line 396.)
Todo
Difficulty: Medium. Document how to install and use chameleon.genshi in tg2.1
(The original entry is located in /tmp/tg2docs/docs/main/Templates/ChameleonGenshi.rst, line 9.)
Todo
Difficulty: Medium. Document writing your own render function for templates
(The original entry is located in /tmp/tg2docs/docs/main/Templates/index.rst, line 38.)
Todo
Difficulty: Medium to Hard. write a tutorial to add a star rating widget to an application
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook.rst, line 138.)
Todo
Difficulty: Medium to Hard. Need some basic dojo widgets here.
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook.rst, line 153.)
Todo
Difficulty: Medium to Hard. write tutorial to show how to update select fields based on other choices
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook.rst, line 182.)
Todo
Difficulty: Medium to Hard. create a tutorial for an ajax enabled progress bar
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook.rst, line 189.)
Todo
Difficulty: Medium to Hard. create a tutorial for a file upload with progress bar
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook.rst, line 196.)
Todo
Difficulty: Medium to Hard. create tutorial for adding tabbed browsing to your website
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook.rst, line 248.)
Todo
Difficulty: Medium. This is nothing but code snippets. Add text describing what the code does.
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook/ActiveForm.rst, line 50.)
Todo
Difficulty: Medium. document the answer to this question: What about if someone is using this widget for a select field, and the value they want returned is the value of the id of an object of select values in a database?
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook/AutoComplete.rst, line 121.)
Todo
Difficulty: Medium. extend tutorial to include the SingleSelectCombo widget in a Form
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook/ExtSingleSelectCombo.rst, line 69.)
Todo
Difficulty: Medium. extend the tutorial to populate the options list by sending a JSON request
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook/ExtSingleSelectCombo.rst, line 70.)
Todo
Difficulty: Medium. extend the tutorial to have form field validation
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook/ExtSingleSelectCombo.rst, line 71.)
Todo
Difficulty: Medium. This entire tutorial is code snippets. Add some text to explain what is going on
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook/ExtTreeView.rst, line 63.)
Todo
Difficulty: Medium. Getting output as JSON and updating a data grid
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Cookbook/JQueryAjaxForm.rst, line 116.)
Todo
Difficulty: Medium. add section about the javascript callbacks
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Creation.rst, line 100.)
Todo
Difficulty: Easy. check this (.child_args), it’s been a while
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Creation.rst, line 170.)
Todo
Difficulty: Hard. get the widget browser working for toscawidgets.org
(The original entry is located in /tmp/tg2docs/docs/main/ToscaWidgets/Library.rst, line 94.)
Todo
Difficulty: Medium. This info is just copied over from the TG1 wiki tutorial, and needs to be vetted, expanded, and edited.
(The original entry is located in /tmp/tg2docs/docs/main/Wiki20/JSONMochiKit.rst, line 6.)
Todo
Difficulty: Medium. update the expose reference article for tg2
(The original entry is located in /tmp/tg2docs/docs/main/Wiki20/JSONMochiKit.rst, line 39.)
Todo
Difficulty: Medium. Understand “variable_provider”: you define tg.config[‘variable_provider’] = callable and that returns a dict with all the variables you want in all templates.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 9.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/7db400f92f652fd4/95c256ac817a5102?hl=en How can I configure genshi?
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 13.)
Todo
Difficulty: Medium. add in notes regarding how to use repoze.who’s user_checker
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 20.)
Todo
Difficulty: Medium. Include these docs: http://groups.google.com/group/turbogears/browse_frm/thread/c2aa4cb5ed07f52d?hl=en Everything there is to know about the current auth/identity in TG2
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 22.)
Todo
Difficulty: Medium. Include these docs: http://groups.google.com/group/turbogears/browse_frm/thread/3afbc13d88af57d3?hl=en TG2 repoze.who and multiple auth sources
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 25.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/f3c2c616f5530426?hl=en Help with Authentication
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 28.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/54306a9fd9b76a7d?hl=en How to check if the user is authorized for a controller or action
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 31.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/f6c61b5f1668e6d3?hl=en Auth can now be configured via config [ini] files percious: priority high
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 34.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/ba405adcabf4f78f?hl=en Configuring LDAP authentication on turbogears2 percious: priority high on this one
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 38.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/4a87b275876647b6?hl=en list of connected users?
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 42.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/9fab648428c20761?hl=en login_handler
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 45.)
Todo
Difficulty: Medium. Include these docs: http://groups.google.com/group/turbogears/browse_frm/thread/f35ef3d347793682?hl=en What’s wrong with predicates being “booleanized”
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 48.)
Todo
Difficulty: Hard. TW2 usage documentation
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 55.)
Todo
Difficulty: Easy. Add note for “validator=Schema(allow_extra_fields=True)” for ToscaWidgets and RestController classes
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 57.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/33a64a06ee4020ce?hl=en Upload images to a TG2 app with Dojo (Ajax style)
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 59.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/bb07ff87d38367f0?hl=en Best way to add fields on the fly to TW Forms?
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 62.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/ca5ddeabdc7cb517?hl=en trying to inject Dojo resources with ToscaWidgets
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 65.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/72e106fc6512b1cb?hl=en Toscawidgets form with multiple buttons priority: low
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 68.)
Todo
Difficulty: Hard. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/a691ae9d3b31138d?hl=en Flash Widget
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 72.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/7d5a07b4a21d7226?hl=en Visitor IP & pre-populated toscawidget field from database
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 75.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/be2939380bfe0f2b?hl=en Using ImageButton() as submit throws an error
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 78.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/c721e2d15bb2c134?hl=en Return to form after custom validation and keep form data?
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 81.)
Todo
Difficulty: Easy. Document the name change of default and lookup methods See http://trac.turbogears.org/ticket/2502
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 87.)
Todo
Difficulty: Medium. Document @restrict decorator, restricts request types that a given method will respond to
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 90.)
Todo
Difficulty: Medium. incorporate custom routes docs from here http://simplestation.com/locomotion/routes-in-turbogears2/ percious: There is a better way of doing this by overriding _dispatch in 2.0 so I would wait until I re-write RoutedController with _dispatch before documenting this
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 92.)
Todo
Difficulty: Hard. RestController requires that all data come in as a key/value pair, can’t just get raw POST body. percious: not sure what you mean by this. You want to provide RestController with just a blob of data? jorge: yes, this was the complain from europe74 this goes against the atom protocol http://tools.ietf.org/html/rfc5023#section-9.2 I think that this needs to be a trac ticket, not a doc todo
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 96.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/ad87eeef701ed1b1?hl=en exception object in ErrorController
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 101.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_thread/thread/3ba7ca9d35fd9d75?fwc=1 mounting test-controllers/getting root-controller instance?
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 104.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/b97ee4faeb6acd53?hl=en CRC does wacky pluralization percious: this should probably be a trac ticket, not a doc todo.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 107.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/d4635f5eb2ad1dc4?hl=en how could a controller method know whether it’s invoked as an error_handler or directly
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 111.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/9b451d82b410f844?hl=en TG2 serveFile equivalent?
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 114.)
Todo
Difficulty: Medium. Include these docs: http://groups.google.com/group/turbogears/browse_frm/thread/1c4158ad3035082c?hl=en Secure Static Files TG2
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 117.)
Todo
Difficulty: Medium. http://turbogears.org/2.0/docs/main/DownloadInstall.html references ttp://www.turbogears.org/2.0/downloads/current/tg2-bootstrap.py and this needs to be updated. Or does it? request from percious, the code to generate the installer currently has tg.devtools/scripts/_installer.py and it’s fixed at 2.0 only update needed is to hg
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 123.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/263233e9a8081c7a?hl=en easy_install and offline installation in virtualenv og TG2 percious: we need to add an offline install section to deployment. This should not be very difficult, it’s basically 2 commands.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 128.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/bbf8c847e77ca740?hl=en TG2 on Webfaction - Make TG not see the extra part of the URL
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 132.)
Todo
Difficulty: Hard. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/92581851b407cdd6?hl=en migrate priority: high
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 138.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/57229bc8677f0e6b/a9843e77e67af793?hl=en Problem with accessing attributes after transaction.commit()
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 141.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/d64d27b2cf54bb2e?hl=en Suggestion about how turbojson handle SQLAlchemy object circuit jorge: this seems like a feature request rather than a docs item
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 144.)
Todo
Difficulty: uncertain. Document how SA+TG+Transaction manager work together.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 147.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/4fc2abf3b91b9ce3?hl=en tg_template is now override_template
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 153.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_thread/thread/1174aad1b3350b5c TurboGears2: Overriding meta element on child template.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 156.)
Todo
Difficulty: Medium. critique the toc, and other organization.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 163.)
Todo
Difficulty: Medium: the TG logo is missing in the new theme. It’s hard to find a place for it where it does not disturb in the new layout.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 169.)
Todo
Difficulty: Hard. add prerequisites to all pages - well, especially tutorials
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 172.)
Todo
Difficulty: Hard. Compare Our Docs to Django Docs <http://docs.djangoproject.com/en/dev/, see where we can do better. Also compare to pylons book!
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 174.)
Todo
Difficulty: Medium. laurin is following the tutorial path. right now, I created a tutorials directory under _static. perhaps, all tutorial images, etc should go in there? just a thought.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 177.)
Todo
Difficulty: Medium. make docs more linky. provide link to pylons, and why tg2 is now based on it. eventually, I’d really like to see links to pylonsbook for specific “more information”, and how turbogears is different/expands upon it
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 181.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/1f9853eac52decd5?hl=en Rolling back transactions in TG2 (I think this is documented, need to double check)
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 185.)
Todo
Difficulty: Hard. Resolve all tickets that match this query: http://trac.turbogears.org/query?status=new&status=assigned&status=reopened&component=Documentation&order=id
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 188.)
Todo
Difficulty: Medium. include links to “read more” - especially true of tutorials that just scratch the surface (this kind of replaces the “more linky” todo)
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 194.)
Todo
Difficulty: Medium. parts is parts: the text on the frontgage of a quickstart says: “standing on the shoulders of giants, since 2007” - provide a main place to see what components are used (by default) in turbogears. don’t be afraid to mention TG2 is built on pylons now, and link to the pylonsbook for more info
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 197.)
Todo
Difficulty: Hard. only after showing the default components - show what components can be easily switched in TG2, and how
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 202.)
Todo
Difficulty: Medium. Add lifecycle of TG project in the getting to know TG section.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 204.)
Todo
Difficulty: Medium. make sure that override_template is more visible, and provide a tutorial on how to use it
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 206.)
Todo
Difficulty: Medium. http://code.google.com/p/tgtools/source/browse/projects/tgext.admin/trunk/tgext/admin/tgadminconfig.py#114 << how to override tgext.admin controllers properly
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 208.)
Todo
Difficulty: Medium. Include these docs: http://groups.google.com/group/turbogears/browse_frm/thread/9b07a8d34611f5d7?hl=en TG2 virtualenv MySQLdb ImportError. Should we be providing documentation to debug MySQLdb problems? Seems out of scope.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 210.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/5dd5b090eb0d4c49?hl=en List of Quickstarted files that are safe to remove percious: I think this is a terrible idea to document
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 214.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/ae89ea2b3a354bc2?hl=en Lukasz Szybalski’s docs: http://lucasmanual.com/mywiki/TurboGears2
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 218.)
Todo
Difficulty: Medium. Document the code_ext extension for Sphinx (docs/code_ext.py) TG documentation writers should be aware of this extension, and how to use it.
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 221.)
Todo
Difficulty: Medium. Include these docs: http://groups.google.com/group/turbogears/browse_frm/thread/4023f34fd114121e?hl=en Trouble with WebHelpers
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 228.)
Todo
Difficulty: Medium. Incorporate these docs: http://groups.google.com/group/turbogears/browse_frm/thread/b718855725da557d?hl=en tgext and i18n
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 231.)
Todo
Difficulty: Hard. Performance deployment enhancements pretty much explain all the YSlow issues * serving static files from the frontent, /config/app_cfg.py base_config.serve_static = False * compressing JS/html/CSS,etc
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 234.)
Todo
Difficulty: Medium. Add shell script which validates environment for building docs
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 238.)
Todo
Difficulty: Medium. main/ToscaWidgets/forms.rst uses the archive directive. This outputs an absolute path relative to root on the machine that builds the docs. Fix the code so it is relative to _build/html/_static
(The original entry is located in /tmp/tg2docs/docs/misc.rst, line 241.)
Todo
Difficulty: Medium. make docs more linky.
(The original entry is located in /tmp/tg2docs/docs/oldindex.rst, line 128.)
Todo
Link to Pylons book for specific “more information”
(The original entry is located in /tmp/tg2docs/docs/oldindex.rst, line 129.)
Todo
link repoze.who, repoze.what, and the other key middleware
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 34.)
Todo
Document initial DB setup in websetup.py
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 50.)
Todo
Link DB setup (MySQL, PostgreSQL, etceteras) docs
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 51.)
Todo
document the transaction module, part of the repoze.tm package, introduction for implementers here… http://repoze.org/tmdemo.html
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 52.)
Todo
Document “community” sites; user-signup mechanisms (e.g. tgext.registration2), OpenID, Recaptcha, etceteras as sub-section
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 82.)
Todo
JQuery, Dojo, EXT usage doc-links
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 145.)
Todo
Link documentation for doing JSON RPC/Ajax here
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 146.)
Todo
Difficulty Medium: document how to “freeze” applications (PIP, zc.buildout, etceteras) for re-deployment with precisely the same software on each machine (no downloads etceteras)
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 167.)
Todo
document use of Nginx beyond just saying you can do it
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 168.)
Todo
(maybe) document use of Twisted WSGI wrapper?
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 169.)
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 199.)
Todo
Difficulty: Medium. optimization tips for SQLAlchemy usage
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 223.)
Todo
Difficulty: Easy. Validate that toctree maxdepth values are appropriate
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 225.)
Todo
Difficulty: Easy. Explain usage of tgscheduler and how to use SQLAlchemy in a task
(The original entry is located in /tmp/tg2docs/docs/recipesandfaq.rst, line 227.)
Todo
Difficulty: Hard. Add testimonials
(The original entry is located in /tmp/tg2docs/docs/testimonials.rst, line 12.)
Todo
Difficulty: Medium. Validate that toctree maxdepth values are appropriate
(The original entry is located in /tmp/tg2docs/docs/toc.rst, line 89.)
Todo
Difficulty: Medium. Validate that this toctree actually reflects what we want. Reduce it as necessary, reorg it, make it somewhat simpler.
(The original entry is located in /tmp/tg2docs/docs/toc.rst, line 91.)
Todo
Difficulty: Hard. Add cardlist manager whitepaper (from m.pedersen)
(The original entry is located in /tmp/tg2docs/docs/whitepapers/cardlist.rst, line 9.)
The existing tutorial is great marketing … very compelling. However, it’s pedagogically weak. It’s too rushed and assumes far too much familiarity with the ORM … and the overall conceptual basis for web development frameworks. For example there’s no explanation of MVC and not discussion of how a new developer would recognize the separation semantics.
Make sure to discuss mod_wsgi more fully < peep1> should tg2/mod_wsgi work slower than stock paste/pylons installation? < peep2> yea, tg2 will be somewhat slower than stock pylons < peep2> genshi is not as fast as mako < peep2> there’s a couple more pre-loaded wsgi middleware components, etc < peep2> if you use mako they get pretty close together
Root Url of app is in environ, SCRIPT_PATH
Don’t use AddRecordForm, use FormBase instead. AddRecordForm automatically disables the primary key fields. The only other difference between AddRecordForm and FormBase is the assignment of the __check_if_unique__ property to True.
Q: How can I enable editing of the ‘id’ field on a Sprox AddRecordForm? A: Override _do_get_disabled_fields(self) in your subclass and return self.__disable_fields__[:]. By default it excludes the field(s) returned by self.__provider__.get_primary_field(self.__entity__) Or, since that is the only feature added by AddRecordForm, don’t use AddRecordForm. XD From the docstrings: “”“Override this function to define how”“”
the tg.config variable is created when middlware.py does the load_environment call well, not created, but updated with the ini file values, etc you can’t use it before that. But all the ini values are passed in to the make_middlware call in middlware.py so you can use them there if you need to
< peep1> hey all, i’m using TG1, and wondering what my options are for making an asynchronous HTTP request from a controller method < peep1> i want the controller to return ASAP, and don’t care about callbacks from the (long-running) HTTP request < peep1> threads don’t seem to work (they get killed off when the controller method exits), and i’d prefer not to go down the rabbit warren of twisted or similar < peep1> calling curl from subprocess seems my best option at the moment, but seems to be The Wrong Solution - any other ideas? < peep2> I’d look into threads, and find out why the thread gets killed, and then fix that. < peep1> ah, rather than started threads directly from the controller, I’ll put a queue in there, see if it helps < peep3> goodgracious: you pretty much need to fork in some way. threads will be no good as the webserver will recycle it as you found out.
< peep1> where should one place robots.txt in a tg2 installation? < peep1> ./public ? < peep2> that should work < peep2> according to pylons docs, public is searched before going through controllers < peep2> I assume this still applies with turbogears < peep1> y, that worked
< peep> map.connect(‘/{lang}/{controller}/’, requirements=dict(lang=’bg|en|ro|ru’))
from tg.controllers import CUSTOM_CONTENT_TYPE
class FilesController(RestController):
@@expose(content_type=CUSTOM_CONTENT_TYPE)
def get_one(self, file_type, *file_path):
file_path = list(file_path)
if pylons.request.response_ext:
file_path[-1]+=pylons.request.response_ext
pylons.response.headers['Content-Type'] = 'text/plain'
pylons.response.headers['Content-Disposition'] = 'attachment; filename="'+file_path[-1]+'"'
return file(file_path, "r").read()