Software Toolkits Building Communities

1
Software ToolkitsBuildingCommunities
Luis Ibáñez KITWARE, Inc.
2
If a tree falls in a forestand nobody is
around to hear it,does it make a sound?
3
No UsersNo Toolkit
4
How to sustain a Toolkit
Developers Mailing List
Moderator
Gatekeeper
CVS Repository
Guru
CMake Configuration
Bad Guy
Dart Dashboard
Czar
Bug Tracking
Volunteer
Doxygen Documentation
5
How to sustain a Toolkit
Writing Tests
XTreme
Outsider
Writing Applications
Prophet
Tutorials
Lawyer
License
6
CVS
Read Only
Read / Write
Repository
7
CVS
For every change in the code, CVS provides an
answer to

• Who ?
• When ?
• What ?
• Why ?

Also Compare with old versions, and Restore old
versions
8
CVS
First step Provide CVS literacy, Tutorials, Se
t up a fake repository for practice
9
CMake
Build configuration
10
CMake
Generating Project Files
NMakeMakefiles
VC 7.0Project.sln
VC 6.0Project.dsw
UnixMakefiles
BorlandMakefiles
11
CMake
Functionalities
CMakeLists.txt
12
Dart
Every line of code is presumed brokenuntil
proven correct
If it is not being compiled and testedchances
are that is broken
13
Dart
DartServer
14
Dart
DartWeb Page
Compare testsAcross platforms
CVSAware
NavigateDates
Doxygen
CodeCoverage
PurifyValgrind
RegressionTesting
15
Dart - Dashboard
16
Dart - Dashboard
17
Dart - Dashboard
18
Bug Tracking
Bug Tracker
19
Bug Tracking
20
Bug Tracking
21
Project Management

• Who is doing what
• Avoid duplication of effort
• Inform users about future developments
• Track progress of sub-projects
• But requires some discipline

22
Project Management
23
Making Releases
24
Doxygen
Generating Documentation from Code
Doxygen
25
Doxygen
Generating Documentation from Code
/ This is documentation / class A /
Convergence criterion / void SetTolerance( float
)
Doxygen
ArticlePages
Equations
Images
UMLClassDiagrams
UMLCollaborationDiagrams
ConceptualGrouping
List of Methods
List ofClasses
26
Communications
FTPfor Data
Weekly TCons
BOF atConferences
Dev. MailingList
Developers
Tutorials atConferences
Users
Tele Conference NetMeeting
Users MailingList
InstantMessaging
DevelopersMeetings
27
Users Mailing List

• Treat the first users very well.
• Usemaybe, perhaps, it seems, it looks like, you
  may want to.
• Train users to report platform, compiler,
  version.
• Assume first that the user is right
• Dont say it works until you test it.
• Collect Frequently Asked Questions (FAQ)

28
Meta Documents

• White Papers
• Journal Papers
• Diagrams
• Slides Presentations
• Books

29
Teaching by Example

• Start from Scratch
• Then simple examples showing only one feature
• Progress toward functional examples
• Provide examples that can be used as tools
• Regression testing examples

30
Are we there yet ?