Changes between Version 4 and Version 5 of DevIntroTutorial


Ignore:
Timestamp:
Apr 3, 2017 3:25:18 PM (8 years ago)
Author:
butler
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • DevIntroTutorial

    v4 v5  
    66 
    77=== OUTLINE === 
    8 2h 42 min (leaves 18 min for final question and discussion session) 
     82h 45 min + 15 min of final question and discussion 
    99 
    10 Paul Butler - 30 min 
     10Paul Butler - 25 min + 5 min questions 
    1111* Welcome and intro = All the areas are important (hard core coding, documentation, checking math, testing that we get the right answers, testing usability and against crashes, responding to help requests)... 
    1212* goals and outline 
    … …  
    1515* Questions/discussion 
    1616 
    17 Andrew Jackson - 25 min 
    18 * 10 min - Getting Help and Bug reporting -- tickets (user list, help@) - '''Needs:''' ''reporting bugs and responders to queries (from “how do i” to “why does my model not fit my data”)'' 
    19 * 10 min - How to write and distribute a model and the model marketplace. '''Needs:''' ''contributing models'' 
    20 * 5 min - Questions/discussion 
     17Andrew Jackson - 20 min + 5 min questions 
     18* Getting Help and Bug reporting -- tickets (user list, help@) - '''Needs:''' ''reporting bugs and responders to queries (from “how do i” to “why does my model not fit my data”)'' 
     19* How to write and distribute a model and the model marketplace. '''Needs:''' ''contributing models'' 
     20* Questions/discussion 
    2121 
    22 Wojciech Potrzebowski - 40 min 
    23 * 35 min - Code structure (where bits live) - '''Needs:''' ''contributing non model code and testing and validation'' 
    24  * 5 min - !SasView, sasmodels, bumps 
    25  * 20 min !SasView 
    26   * 10 min - sasGUI 
    27   * 10 min - sasCalc 
    28  * 10 min - sasmodels 
    29 * 5 min - Questions/discussion 
     22Wojciech Potrzebowski - 35 min + 5 min questions 
     23* Code structure (where bits live) - '''Needs:''' ''contributing non model code and testing and validation'' 
     24 * Overview - !SasView, sasmodels, bumps 
     25 * !SasView 
     26  * sasGUI 
     27  * sasCalc 
     28 * sasmodels 
     29* Questions/discussion 
    3030 
    31 Stephen King and Paul Butler - 25 min 
    32 * 20 min - Documentation - '''Needs:''' ''contributing documentation'' 
    33  * 5 min - Overview  
     31Stephen King and Paul Butler - 20 min + 5 min questions 
     32* Documentation - '''Needs:''' ''contributing documentation'' 
     33 * Overview  
    3434  * Use Sphinx to build both dev and user 
    3535  * Uses RST and Latex - currently builds html but plan for a pdf also 
    36  * 4 min - Dev - '''Needs:''' ''lots of doc strings still missing'' 
    37   * 4 min - docstrings at the start of “each” class and method 
    38  * 10 min - User - '''Needs:''' ''never finished''  
    39   * 5 min - each section has an RST file (and images as appropriate) 
    40   * 5 min - Models = the first doc string in the file is scraped to go into model documentation 
     36 * Dev - '''Needs:''' ''lots of doc strings still missing'' 
     37  * docstrings at the start of “each” class and method 
     38 * User - '''Needs:''' ''never finished''  
     39  * Each section has an RST file (and images as appropriate) 
     40  * Models = the first doc string in the file is scraped to go into model documentation 
    4141  * 1 min - Tutorial …. Need a new one - '''Needs:''' ''help developing tutorial materials'' 
    42 * 5 min - Questions/discussion 
     42* Questions/discussion 
    4343 
    44 Andrew Jackson and Wojciech Potrzebowski - 45 min 
    45 * 37 min - “Dev ops” 
    46  * 2 min - Basic concepts in version control - '''EVERYTHING''' is under version control!! 
    47  * 10 min Git code hosting 
    48   * 7 min - Concepts in version control (repos, cloning, branching (vs. forking - baaaad), committing (with comments),pull requests, code review 
    49   *3 min - Setting notifications etc  
    50  * 25 min - “show me the code”- '''Needs:''' ''developers of all stripes = architecture, GPU, math whiz, sysadmins, ...'' 
    51   * 5 min - Git code repos (all of them), branches, stats… and CODE 
    52   * 5 min - Compiling/run.py and local environment 
    53   * 5 min - Py2exe and Ino -> installer 
    54   * 5 min - CI - eventually NOT local environment - real test is final build 
     44Andrew Jackson and Wojciech Potrzebowski - 40 min  + 5 min questions 
     45* “Dev ops” 
     46 * Basic concepts in version control - '''EVERYTHING''' is under version control!! 
     47 * Git code hosting 
     48  * Concepts in version control (repos, cloning, branching (vs. forking - baaaad), committing (with comments),pull requests, code review 
     49  * Setting notifications etc  
     50 * “show me the code”- '''Needs:''' ''developers of all stripes = architecture, GPU, math whiz, sysadmins, ...'' 
     51  * Git code repos (all of them), branches, stats… and CODE 
     52  * Compiling/run.py and local environment 
     53  * Py2exe and Ino -> installer 
     54  * CI - eventually NOT local environment - real test is final build 
    5555   * Travis 
    5656   * Jenkins 
    57   * 5 min - progress  -->trac → ticket -> work 
     57  * Progress  -->trac → ticket -> work 
    5858   * Trac wiki 
    5959   * Trac tickets, milestones, workpackages, roadmap (trac version) 
    60 * 5 min - Questions/discussion 
     60* Questions/discussion 
    6161 
    6262GENERAL QUESTIONS/DISCUSSION