1 / 31

uPortal Documentation Roadmap

uPortal Documentation Roadmap. John Fereira, Cornell University Andrew Petro, Yale University. Official web site JA-SIG Wiki Mailing lists Jira Issue Tracking system Future of uPortal Documentation How you can contribute. Overview. URL: http://www.uportal.org

Download Presentation

uPortal Documentation Roadmap

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript


  1. uPortal Documentation Roadmap John Fereira, Cornell University Andrew Petro, Yale University

  2. Official web site JA-SIG Wiki Mailing lists Jira Issue Tracking system Future of uPortal Documentation How you can contribute Overview

  3. URL: http://www.uportal.org See also: http://www.ja-sig.org demo Official uPortal Website

  4. URL: http://jasigch.princeton.edu:9000 Open to anyone Spaces JA-SIG uPortal uPortal Channels Portlets Central Authentication Service Integrated with Issue Tracking System Demo uPortal Wiki

  5. jasig-announce@unm.edu Low traffic Open membership uPortal releases, conferences, training classes Archive: https://list.unm.edu/cgi-bin/wa?A0=jasig-announce jasig-portal@unm.edu High traffic Open membership Discuss anything related to uPortal Archive: https://list.unm.edu/cgi-bin/wa?A0=jasig-portal jasig-dev@unm.edu Medium traffic Membership restricted to uPortal framework developers Coordination of development work Archive: https://list.unm.edu/cgi-bin/wa?A0=jasig-dev uPortal Mailing Lists

  6. Documentation in xml (Anakia) http://jasigch.princeton.edu/uportaltest/index.html Future of uPortal Documentation

  7. http://jasigch.princeton.edu:9000/jira uPortal Issue Tracking System

  8. Commercial product free to our open-source project Java web application hosted on Clearinghouse machine Successor to our Bugzilla What is JIRA?

  9. Issues are a superset of Bugs Bugs New Features Improvements Tasks

  10. Documenting Known Issues

  11. Change Logs / Release Notes

  12. Planning future releases

  13. Understanding Risk / Obstacles

  14. Developers take issues, becoming Assignees. Assignees are responsible for resolving the issue. They “start progress” on an issue to indicate actively working on it. Once they think it’s resolved, they mark it resolved. Assignees

  15. Submitting an issue

  16. Select project and issue type

  17. Summarize, Categorize

  18. Describe

  19. Reporters have an important role

  20. Comment

  21. CVS Integration and patching

  22. Speaking of Patches

  23. Vote?

  24. Our issue tracking and reporting is only as good as its data You can help by reporting issues Keeping “affects version” metadata correct Drawing attention to important issues we’re overlooking Commenting, adding your insight Posting patches Help track issues

  25. Contribute to the Wiki

  26. Perhaps start with…

  27. Wikis are all about collaborative editing There’s built in versioning and rollback So please feel welcome to edit But you can also post comments Even if you’re not ready to edit…

  28. Notice something outdated, something to fix, something confusing? Open an issue Post a patch Committer? Edit the CVS. Instant gratification. uPortal documentation has an issue tracking space in JIRA. Contribute to the static website

  29. We aspire to be Friendly Welcoming Mutually supportive You have experiences, answers to share Help on the mailing lists

  30. Help Harvest from the Lists Email: Pros: Threaded discussion Freeform Flexible Cons: Becomes “stale” very quickly Not easily updateable, editable Scrolls off the top of our inboxes to be forgotten Tracking concrete issue tokens Capture the “final answer” – and able to update when the final answer Changes.

  31. Speakers: John Fereira and Andrew Petro Track: New Concepts Presentation Title: uPortal Documentation Roadmap Date: 06/14/2005 Time: 2:00 PM – 3:00 PM The End Questions ? Speaker Evaluation Info:

More Related