Oy Laatukonsultointi P. Kantelinen Ab

# (#)



Documentation - sources

  1. Construx document templates
  2. Wikipedia article about wikis
  3. List of wiki software(in Wikipedia)
  4. Wiki Engines at c2.com
  5. Open Source Wiki Engines in Java, Java-Source.net
  6. Wiki Matrix Comparison of different wiki engines
  7. The Wiki Design Principles
  8. Construx CxOne process, includes also documentation templates, among other things
  9. Many Eyes visualizations
  10. Tigris Open source document templates
  11. esimerkki pienen ohjelmistoyrityksen www-pohjaisesta laatukäsikirjasta (TTKK:n Ohjelmistotekniikan laitoksen tekemä), sisältää useita dokumenttipohjia
  12. R.S. Pressman & Associates Software Engineering Document Templates
  13. IEEE Software Engineering starndards, include several standards for documentation:
    IEEE Standards Association (Orders, see Products > Catalog > Standards Topical Listing > Software Design/Development & Software Quality and Management) or
    Online subscription of software engineering standards
  14. TCSE: Technical Council on Software Engineering, IEEE Computer society, see Commitees = > Reverse Engineering and Reengineering => Resource Repository
  15. Michele Lanza's publications - good papers about software visualization
  16. Documentation templates for database projects
  17. Brad Appleton's Design Specification Template
  18. Literate Programming home
  19. Agile Documentation
  20. Artifacts for Agile Modeling: The UML and Beyond
  21. S.W. Ambler: "Agile Documentation Strategies", Better Software, pp. 67 - 69, March 2007
  22. W.S. Bennet: Visualizing Software. A Graphical Notation for Analysis, Design, and Discussion., Marcel Dekker, 1992 (examples of graphical notation to be used in documents)
  23. G. Booch, J. Rumbaugh, I. Jacobson: The Unified Modeling Language User Guide. Addison Wesley, 1999 (examples of graphical notation to be used in documents)
  24. R. J. Brockmann: Writing Better Computer User Documentation, From Paper To On Line, Wiley, 1986
  25. B. Button: ”Double Duty. How to repurpose the unit tests you're doing to help create the documentation you're not”, Better Software, pp. 14 - 23, February 2005
  26. M. Coe: Human Factors for Technical Communicators, Wiley, 1996
  27. J. Crown: Effective Computer User Documentation, Van Nostrand Reinhold, 1992
  28. S. Ducasse, M. Lanza: "The Class Blueprint: Visually Supporting the Understanding of Classes", IEEE Transactions on Software Engineering, pp. 75 - 90, January 2005
  29. L. Dupre: Bugs in Writing Revised: A Guide to Debugging Your Prose, Addison-Wesley Professional, 1998
  30. B.P. Douglas: Real-Time UML - Developing Efficient Object for Embedded Systems, Addison Wesley, 1998 (examples of graphical notation to be used in documents of real-time software)
  31. A. Ebersbach, M. Glaser, R. Heigl: Wiki: Web Collaboration, Springer 2005
  32. S. G. Eick, P. Schuster, A. Mockus, T. L. Graves,, A. F. Karr: Visualizing Software Changes, National Institute of Statistical Sciences, Technical Report Number 113, December, 2000
  33. E. Lawson Ferlazzo:" eXtreme Documentation and Design", Sprezzaura Systems, Inc.
  34. R.G. Gabriel: Writer's Workshops and the Work of Making Things, Addison-Wesley, 2002
  35. H. Gomaa: Software Design Methods for Concurrent and Real-time Systems, Addison Wesley, 1993 (examples of graphical notation to be used in documents of real-time software)
  36. I. T. Bowman. R. C. Holt, N. V. Brewster: Linux as a Case Study: Its Extracted Software Architecture, at Internationl Conference on Software Engineering, Los Angeles, May 16 - 22, 1999
  37. W. Horton: Illustrating Computer Documentation. The Art of Presenting Information on Paper and Online, Wiley, 1991
  38. B. Kernighan, R. Pike: The Practice of Programming, Addison-Wesley, 1999
  39. J. Kotula: "Using Patterns to Create Component Documentation", IEEE Software, March/April 1998
  40. T.C. Lethbridge, J. Singer, A. Forward: "How Software Enginers Use Documentation: The State of the Practice", IEEE Software, pp. 35 - 39, November/December 2003
  41. B. Leuf, W. Cunningham: The Wiki Way: Quick Collaboration on the Web, Addison-Wesley, 2001
  42. P. Louridas: "Using Wikis in Software Development", IEEE Software, pp. 88-91, March/April 2006
  43. Luqi, L. Zhang, V. Berzins, Y. Qiao: "Documentation Driven Development for Complex Real-Time Systems", IEEE Transaction on Software Engineering, pp. 936 - 952, December 2004
  44. A. Marcus: Graphic Design for Electronic Documents and User Interfaces, ACM Press (Addison-Wesley), 1992
  45. N. Marovac: "Guidelines for Embedded SW Documentation", Software Engineering Notes, April 1994
  46. R.A. McGrath: Where’s the Manual, Van Nostrand Reinhold, 1991
  47. R.C. Parker: Looking Good in Print. A Guide to Basic Design for Desktop Publishing, Ventana Press, 1993
  48. V. Rajlich: "Incremental Redocumentation Using the Web", IEEE Software, September/November 2000
  49. N. Ramsey: "Literate Programming Simplified", IEEE Software, September 1994
  50. A. Rueping: Agile Documentation: A Pattern Guide to Producing Lightweight Documents for Software Projects, John Wiley and Sons, 2003
  51. J. Rumbaugh, I. Jacobson, G. Booch: The Unified Modeling Language User Guide, Addison-Wesley, 1998
  52. J. Rumbaugh, I. Jacobson, G. Booch: The Unified Modeling Language Reference Manual, Addison-Wesley, 1999
  53. A. Rüping: Agile Documentation: A Pattern Guide to Producing Lightweight Documents for Software Projects, Wiley & Sons (Wiley Software Patterns Series), 2003
  54. A.R. Simon & J. Simon: Computer Professionals Guide to Effective Communications, McGraw-Hill, 1993
  55. W. Strunk Jr., E.B. White, R. Angell: The Elements of Style, Fourth Edition, Longman, 2000
  56. G. M. Weinberg: Weinberg on Writing: The Fieldstone Method, Dorset House Publishing, 2005
  57. T. Wells: Dynamic Software Development: Managing Projects in Flux,  Auerbach, 2002
  58. D. M. Zokaites: "Writing Understandable Code", Software Development, pp. 48 - 50, January 2002
  59. Toimiston asiakirjat. Standardit, SFS Käsikirja 76, SFS, 2000 (asiakirjojen layout-standardit)