diff options
| -rw-r--r-- | spm-slides.tex | 236 |
1 files changed, 149 insertions, 87 deletions
diff --git a/spm-slides.tex b/spm-slides.tex index d557119..53e052e 100644 --- a/spm-slides.tex +++ b/spm-slides.tex @@ -536,6 +536,114 @@ git checkout FIX-README %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\foilhead{Announcing} + +Show your \underline{presentable} work to the world. + +Put the announcement on the project home page. + +Post the announcement in the appropriate forums. One post per forum. + +General forum: https://news.ycombinator.com/ + +https://www.reddit.com/r/ subdirectories: opensource, programming, software. + +Topic-specific forums: mailing lists, web forums. + +Register at: \href{https://freshcode.club/}{fresh(code)}, \href{http://openhub.net/}{Black Duck Open Hub}. + +Make sure your announcement contain keywords that would help search engines find your project. + +Your announcement should be short and to the point. + +{\tiny +\begin{verbatim} + To: discuss@some.forum.about.search.indexers + Subject: [ANN] Scanley, a new full-text indexer project. + Reply-to: dev@scanley.org + + This is a one-time post to announce the creation of the Scanley + project, an open source full-text indexer and search engine with a + rich API, for use by programmers in providing search services for + large collections of text files. Scanley is now running code, is + under active development, and is looking for both developers and + testers. + + Home page: http://www.scanley.org/ + + Features: + - Searches plain text, HTML, and XML + - Word or phrase searching + - (planned) Fuzzy matching + - (planned) Incremental updating of indexes + - (planned) Indexing of remote web sites + - (planned) Long-distance mind-reading + + Requirements: + - Python 3.2 or higher + - SQLite 3.8.1 or higher + For more information, please come find us at scanley.org! + + Thank you, + -J. Random +\end{verbatim} +} + +Running code provides the best foundation for success. + +Without running code? It may also work. Subversion (a design document, core developers). But there has to be something {\bf concrete/tangible} than just good intentions. + +You can announce after you made the project open-source. + +What you should expect: + +- {\bf No big impact}. Keep 1.0 quiet. + +- Some casual inquires. + +- A few more people in your mailing list. + +Announcing is seeding. + +Form exponential communications networks. + +Project $\rightarrow$ Community. + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\foilhead{More Comments than Code} + +Not only code comments. + +But also Pull Request Comments. +% https://ben.balter.com/2017/05/23/seven-ways-to-consistently-ship-great-features/ + +{\small +\begin{verbatim} +Software Code Comment Code/Comment +--------------------------------------------------------- +GNU Nano 17718 3773 4.7 +Git 474195 63652 7.4 +Ubuntu 600750 120283 5.0 +Apache HTTP Server 1512918 160160 9.4 +MySQL 8631127 2754165 3.1 +OpenStack 12951523 3146489 4.1 +Android 16218632 4849352 3.3 +Firefox 20684598 4528549 4.6 +Linux Kernel 36680915 6701533 5.5 +KDE 58707319 14434617 4.1 + + +December 2019 Data + +Source: OpenHub https://www.openhub.net/ + +Copyright (C) 2020 Lan Hui +\end{verbatim} +} + + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \foilhead{Refactoring Old Code and Building Upon It} @@ -623,13 +731,14 @@ Management styles: Convert code into products below the decks. -Quiet private office, a great computer, unlimited beverages, an comfortable ambient temperature. +Quiet private office, a great computer, unlimited beverages, a comfortable ambient temperature. -Roman army: four servants for every soldier. +Roman army: 4 servants for every soldier. Modern army: 7:1. ``Even minor frustrations caused by using under-powered tools add up, making programmers grumpy and unhappy. And a grumpy programmer is an unproductive programmer.'' - Joel Spolsky. + Dolly Parton. Bad management: \href{https://www.joelonsoftware.com/2006/08/09/the-econ-101-management-method/}{Econ 101 management}. ``Management simply doesn’t know how to teach people to do better work, so they force everybody in the system to come up with their own way of doing it.'' @@ -654,7 +763,9 @@ A good manager is a role model. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \foilhead{Micromanagement} -TBD. + +Cannot {\em scale}. + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \foilhead{Customers} @@ -1678,15 +1789,6 @@ Writing is so powerful that we are still able to read people's thoughts after th For example, books written in 1810, 1859, etc. -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\foilhead{More Comments than Code} - -Not only code comments. - -But also Pull Request Comments. -% https://ben.balter.com/2017/05/23/seven-ways-to-consistently-ship-great-features/ - - %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \foilhead{Code review} @@ -1931,80 +2033,6 @@ Solution: %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\foilhead{Announcing} - -Show your \underline{presentable} work to the world. - -Put the announcement on the project home page. - -Post the announcement in the appropriate forums. One post per forum. - -General forum: https://news.ycombinator.com/ - -https://www.reddit.com/r/ subdirectories: opensource, programming, software. - -Topic-specific forums: mailing lists, web forums. - -Register at: \href{https://freshcode.club/}{fresh(code)}, \href{http://openhub.net/}{Black Duck Open Hub}. - -Make sure your announcement contain keywords that would help search engines find your project. - -Your announcement should be short and to the point. - -{\tiny -\begin{verbatim} - To: discuss@some.forum.about.search.indexers - Subject: [ANN] Scanley, a new full-text indexer project. - Reply-to: dev@scanley.org - - This is a one-time post to announce the creation of the Scanley - project, an open source full-text indexer and search engine with a - rich API, for use by programmers in providing search services for - large collections of text files. Scanley is now running code, is - under active development, and is looking for both developers and - testers. - - Home page: http://www.scanley.org/ - - Features: - - Searches plain text, HTML, and XML - - Word or phrase searching - - (planned) Fuzzy matching - - (planned) Incremental updating of indexes - - (planned) Indexing of remote web sites - - (planned) Long-distance mind-reading - - Requirements: - - Python 3.2 or higher - - SQLite 3.8.1 or higher - For more information, please come find us at scanley.org! - - Thank you, - -J. Random -\end{verbatim} -} - -Running code provides the best foundation for success. - -Without running code? It may also work. Subversion (a design document, core developers). But there has to be something {\bf concrete/tangible} than just good intentions. - -You can announce after you made the project open-source. - -What you should expect: - -- {\bf No big impact}. Keep 1.0 quiet. - -- Some casual inquires. - -- A few more people in your mailing list. - -Announcing is seeding. - -Form exponential communications networks. - -Project $\rightarrow$ Community. - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \foilhead{Why open source?} % https://ben.balter.com/2015/11/23/why-open-source/ @@ -2295,7 +2323,27 @@ Buddying system. Get confirmation from another guy ({\em buddy}) first before f you search the bug tracker to see if it's already been reported?" -%Omit IRC / Real-Time Chat Systems + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\foilhead{Internet Relay Chat} + +Or IRC for short. + +Real-time chat systems. + +Text-based. + +Many IRC channels running on an IRC server (e.g., irc.freenode.org). + +Channel topic. + +Use pastebins (paste sites) for large text or images. + +Bots. + +Commit notifications in IRC. + + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \foilhead{Wikis} @@ -2316,6 +2364,16 @@ Extensive guidance on how to write new entries. What to avoid. Dispute resolut https://stackoverflow.com + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\foilhead{Social Networking} + +Presence on mainstream social media platform. + +@AskLibreOffice tweet stream. + + + %% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% \foilhead{Translation infrastructure} @@ -2776,6 +2834,10 @@ that he is doing his job, that he is paying attention, that he is here. \underline{The ``Noisy Minority'' effect}. The best way to counteract this effect is to point it out very clearly and provide supporting evidence showing how small the actual number of dissenters is, compared to those in agreement. + +\underline{Hawthorne effect}. + + \underline{Holy wars}. Find some way to express sympathy and understanding for the points the other side is making. \underline{Bash competing open source products}. Refrain from giving negative {\em opinions} about competing open source software. One reason: developers overlap. |