From 09a26278c59efd07c917e199f6af0160b7cb9ab6 Mon Sep 17 00:00:00 2001
From: Hui Lan <lanhui@zjnu.edu.cn>
Date: Tue, 14 May 2019 08:48:29 +0800
Subject: spm-slides.tex: finished Technical Debt.  Revise Be open from day
 one, Opening a formerly closed project, Announcing

---
 spm-slides.tex | 32 ++++++++++++++++++++++++--------
 1 file changed, 24 insertions(+), 8 deletions(-)

(limited to 'spm-slides.tex')

diff --git a/spm-slides.tex b/spm-slides.tex
index 922aee8..7b3be2b 100644
--- a/spm-slides.tex
+++ b/spm-slides.tex
@@ -925,7 +925,15 @@ the single reviewer.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \foilhead{Technical debt}
 
-tbd
+Like financial debt.  It is a debt, and you need to pay it off in the future (with interest).
+
+``When taking {\em short cuts} and delivering code that is not quite right for the programming task of the moment, a development team incurs Technical Debt. This debt decreases productivity. This loss of productivity is the interest of the Technical Debt.''
+
+High technical debt would make the software not maintainable.
+
+FIXME.
+
+https://www.agilealliance.org/introduction-to-the-technical-debt-concept/
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \foilhead{Be open from day one}
@@ -954,10 +962,10 @@ Note: cleaning up needs extra time and decision-making.  Also, you don't want al
 
 - Developer discussion forums
 
-And your daily work is visible to the public.
+Your daily work is visible to the public.  Compatible with being open source.
 
 \newpage
-``In the open'' does NOT mean
+``In the open'' does NOT have to mean the following
 
 - allowing strangers to check code into your repository
 
@@ -975,6 +983,8 @@ And your daily work is visible to the public.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \foilhead{Opening a formerly closed project}
 
+Like exposing your underwear to the world.
+
 Mechanical difficulties you may encounter:
 
 Your code depends on proprietary, platform-dependent libraries. 
@@ -982,7 +992,7 @@ Your code depends on proprietary, platform-dependent libraries.
 Confidential data (e.g., unpublishable comments, passwords or
 site-specific configuration information).
 
-Solutions: open-source libraries, \underline{``top-skim''} version.
+Solutions: use open-source libraries, start from \underline{``top-skim''} version.
 
 Managerial issues (1) make sure everyone in the team understand that a BIG change is coming. (2) make sure that you understand how it's going to feel from their point of view.
 
@@ -994,7 +1004,7 @@ Managerial issues (1) make sure everyone in the team understand that a BIG chang
 
 - Lots of questions from strangers suggest inadequate documentation.  Burden of external communications.
 
-Solution: the above discomfort is perfectly normal.
+Solution:  Don't worry.  The above discomfort is perfectly normal.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \foilhead{Announcing}
@@ -1005,10 +1015,14 @@ Put the announcement on the Project Homepage.
 
 Post the announcement in the appropriate forums.   One post per forum.
 
-General: https://news.ycombinator.com/
+General forum: https://news.ycombinator.com/
 
 https://www.reddit.com/r/ subdirectories: opensource, programming, software.  Topic-specific forums: mailing lists. 
 
+https://freshcode.club/
+
+http://openhub.net/
+
 Make sure your announcement contain keywords that would help search engines find your project.
 
 Your announcement should be short and to the point.
@@ -1048,7 +1062,7 @@ Your announcement should be short and to the point.
 
 Running code provides the best foundation for success.
 
-Without running code?  It may also work.  Subversion, Mozilla.   But there has to be something {\bf concrete/tangible}.
+Without running code?  It may also work.  Subversion (a design document, core developers), Mozilla.   But there has to be something {\bf concrete/tangible} than just good intentions.
 
 You can announce after you made the project open-source.
 
@@ -1060,7 +1074,9 @@ What you should expect:
 
 - A few more people in your mailing list.
 
-Seed.  From project to community.
+Announcing is Seeding.
+
+Form exponential communications networks.  From project to community.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \foilhead{Why open source?}
-- 
cgit v1.2.1

