1. June 14, 2005 uPortal Summer Conference, Baltimore, MD John Fereira, Cornell University Andrew Petro, Yale University uPortal Documentation Roadmap

2. June 14, 2005 uPortal Summer Conference, Baltimore, MD Overview Official web site JA-SIG Wiki Mailing lists Jira Issue Tracking system Future of uPortal Documentation How you can contribute

3. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website URL: http://www.uportal.orghttp://www.uportal.org See also: http://www.ja-sig.orghttp://www.ja-sig.org demo

4. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website (cont.)

5. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website (cont.)

6. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website (cont.)

7. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website (cont.)

8. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website (cont.)

9. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website (cont.)

10. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website (cont.)

11. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website (cont.)

12. June 14, 2005 uPortal Summer Conference, Baltimore, MD Official uPortal Website links Main docs page: http://www.uportal.org/docs.htmlhttp://www.uportal.org/docs.html Roles: http://www.uportal.org/roles.htmlhttp://www.uportal.org/roles.html Administrator pages: http://www.uportal.org/administrators/index.html http://www.uportal.org/administrators/index.html Implementation pages: http://www.uportal.org/implementors/index.html http://www.uportal.org/implementors/index.html Developer pages: http://www.uportal.org/developers/index.htmlhttp://www.uportal.org/developers/index.html User/Subscriber pages: http://www.uportal.org/users/index.htmlhttp://www.uportal.org/users/index.html Meetings: http://www.uportal.org/meetings/index.htmlhttp://www.uportal.org/meetings/index.html Release notes: http://www.uportal.org/release/notes.htmlhttp://www.uportal.org/release/notes.html Additional links: http://www.uportal.org/additional.htmlhttp://www.uportal.org/additional.html Link to Wiki: http://jasigch.princeton.edu:9000/http://jasigch.princeton.edu:9000/

13. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki URL: http://jasigch.princeton.edu:9000http://jasigch.princeton.edu:9000 Open to anyone Spaces Integrated with Issue Tracking System Demo

14. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki

15. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki

16. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki

17. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki

18. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki

19. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki

20. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki

21. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Wiki

22. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Mailing Lists jasig-announce@unm.edu –Low traffic –Open membership –uPortal releases, conferences, training classes –Archive: https://list.unm.edu/cgi-bin/wa?A0=jasig-announcehttps://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-portalhttps://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-devhttps://list.unm.edu/cgi-bin/wa?A0=jasig-dev

23. June 14, 2005 uPortal Summer Conference, Baltimore, MD Future of uPortal Documentation Move old, obsolete documentation to wiki (uPortal 1) Migrate content developed on wiki to main site Capture more mailing list content on wiki Documentation in xml (Anakia) http://jasigch.princeton.edu/uportaltest/index.html

24. June 14, 2005 uPortal Summer Conference, Baltimore, MD uPortal Issue Tracking System http://jasigch.princeton.edu:9000/jira

25. June 14, 2005 uPortal Summer Conference, Baltimore, MD What is JIRA? Commercial product free to our open- source project Java web application hosted on Clearinghouse machine Successor to our Bugzilla

26. June 14, 2005 uPortal Summer Conference, Baltimore, MD Issues are a superset of Bugs Bugs New Features Improvements Tasks

27. June 14, 2005 uPortal Summer Conference, Baltimore, MD Documenting Known Issues

28. June 14, 2005 uPortal Summer Conference, Baltimore, MD Change Logs / Release Notes

29. June 14, 2005 uPortal Summer Conference, Baltimore, MD Planning future releases

30. June 14, 2005 uPortal Summer Conference, Baltimore, MD Understanding Risk / Obstacles

31. June 14, 2005 uPortal Summer Conference, Baltimore, MD Assignees 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.

32. June 14, 2005 uPortal Summer Conference, Baltimore, MD Submitting an issue

33. June 14, 2005 uPortal Summer Conference, Baltimore, MD Select project and issue type

34. June 14, 2005 uPortal Summer Conference, Baltimore, MD Summarize, Categorize

35. June 14, 2005 uPortal Summer Conference, Baltimore, MD Describe

36. June 14, 2005 uPortal Summer Conference, Baltimore, MD Reporters have an important role

37. June 14, 2005 uPortal Summer Conference, Baltimore, MD Comment

38. June 14, 2005 uPortal Summer Conference, Baltimore, MD CVS Integration and patching

39. June 14, 2005 uPortal Summer Conference, Baltimore, MD Speaking of Patches

40. June 14, 2005 uPortal Summer Conference, Baltimore, MD Vote?

41. June 14, 2005 uPortal Summer Conference, Baltimore, MD Help track issues 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

42. June 14, 2005 uPortal Summer Conference, Baltimore, MD Contribute to the Wiki

43. June 14, 2005 uPortal Summer Conference, Baltimore, MD Perhaps start with…

44. June 14, 2005 uPortal Summer Conference, Baltimore, MD Even if you’re not ready to edit… 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

45. June 14, 2005 uPortal Summer Conference, Baltimore, MD Contribute to the static website 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.

46. June 14, 2005 uPortal Summer Conference, Baltimore, MD Help on the mailing lists We aspire to be –Friendly –Welcoming –Mutually supportive You have experiences, answers to share

47. June 14, 2005 uPortal Summer Conference, Baltimore, MD 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.

48. June 14, 2005 uPortal Summer Conference, Baltimore, MD 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 Speaker Evaluation Info: The End Questions ?