Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
skip to main content
10.1145/2597073.2597106acmconferencesArticle/Chapter ViewAbstractPublication PagesicseConference Proceedingsconference-collections
Article

How does a typical tutorial for mobile development look like?

Published: 31 May 2014 Publication History

Abstract

We report on an exploratory study, which aims at understanding how development tutorials are structured, what types of tutorials exist, and how official tutorials differ from tutorials written by development communities. We analyzed over 1.200 tutorials for mobile application development provided by six different sources for the three major platforms: Android, Apple iOS, and Windows Phone. We found that a typical tutorial contains around 2700 words distributed over 4 pages and including a list of instructions with 18 items. Overall, 70% of the tutorials contain source code examples and a similar fraction contain images. On average, one tutorial has 6 images. When analyzing the images, we found that the studied iOS community posted the largest number of images, 14 images per tutorial, on average, from which 74% are plain images, i.e., mainly screenshots without stencils, diagrams, or highlights. In contrast, 36% of the images included in the official tutorials by Apple were diagrams or images with stencils. Community sites seem to follow a similar structure to the official sites but include items and images which are rather underrepresented in the official tutorials. From the analysis of the tutorials content by means of natural language processing combined with manual content analysis, we derived four categories for mobile development tutorials: infrastructure and design, application and services, distribution and maintenance, and development platform. Our categorization can help tutorial writers to better organize and evaluate the content of their tutorials and identify missing tutorials.

References

[1]
L. Bergman, V. Castelli, T. Lau, and D. Oblinger. Docwizards: a system for authoring follow-me documentation wizards. In In Proc. ACM UIST, pages 191–200. ACM Press, 2005.
[2]
C. Bird, A. Gourley, P. Devanbu, M. Gertz, and A. Swaminathan. Mining email social networks. In MSR’06, MSR ’06, pages 137–143, New York, NY, USA, 2006. ACM.
[3]
D. M. Blei, A. Y. Ng, and M. I. Jordan. Latent dirichlet allocation. J. Mach. Learn. Res., 3:993–1022, Mar. 2003.
[4]
J. M. Carroll and M. B. Rosson. Paradox of the active user. In J. M. Carroll, editor, Interfacing thought: cognitive aspects of human-computer interaction, chapter Paradox of the active user, pages 80–111. MIT Press, Cambridge, MA, USA, 1987.
[5]
B. Dagenais and M. P. Robillard. Creating and evolving developer documentation: Understanding the decisions of open source contributors. In SIGSOFT’10, pages 127–136, November 2010.
[6]
S. M. Harrison. A comparison of still, animated, or nonillustrated on-line help with written or spoken instructions in a graphical user interface. In SIGCHI ’95, CHI ’95, pages 82–89, New York, NY, USA, 1995. ACM Press/Addison-Wesley Publishing Co.
[7]
J. D. Herbsleb and E. Kuwana. Preserving knowledge in design projects: what designers need to know. In Proceedings of the Joint INTERACT ’93 and CHI ’93 Conferences on Human Factors in Computing Systems, pages 7–14, 1993.
[8]
S. Y. Jeong, Y. Xie, J. Beaton, B. A. Myers, J. Stylos, R. Ehret, J. Karstens, A. Efeoglu, and D. K. Busse. Improving documentation for eSOA APIs through user studies. In Proc. 2nd Int’l Symp. on End-User Development, volume 5435 of LNCS, pages 86–105. Springer, 2009.
[9]
C. Kelleher and R. Pausch. Stencils-based tutorials: design and evaluation. In Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI ’05, pages 541–550, New York, NY, USA, 2005. ACM.
[10]
D. E. Knuth. Literate programming. Comput. J., 27(2):97–111, 1984.
[11]
A. J. Ko, R. DeLine, and G. Venolia. Information needs in collocated software development teams. In ICSE ’07. IEEE Computer Society, 2007.
[12]
W. Maalej and H.-J. Happel. Can development work describe itself? In MSR ’10. IEEE, 2010.
[13]
W. Maalej and M. P. Robillard. Patterns of knowledge in api reference documentation. IEEE Transactions on Software Engineering, 39(9):1264–1282, 2013.
[14]
J. Mylopoulos, A. Borgida, and E. Yu. Representing software engineering knowledge. Automated Software Engineering, 4(3):291–317, 1997.
[15]
K. Nørmark. Elucidative programming. Nordic J. of Computing, 7(2):87–105, June 2000.
[16]
J. Nykaza, R. Messinger, F. Boehme, C. L. Norman, M. Mace, and M. Gordon. What programmers really want: Results of a needs assessment for SDK documentation. In Proceedings of the 20th Annual ACM SIGDOC International Conference on Computer Documentation, pages 133–141, 2002.
[17]
D. Pagano and W. Maalej. How do open source communities blog? Empirical Software Engineering, pages 1–35, 2012.
[18]
D. Pagano and W. Maalej. User feedback in the appstore: An empirical study. In RE, pages 125–134, 2013.
[19]
S. Palmiter and J. Elkerton. An evaluation of animated demonstrations of learning computer-based tasks. In Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI ’91, pages 257–263, New York, NY, USA, 1991. ACM.
[20]
M. F. Porter. Readings in information retrieval. chapter An Algorithm for Suffix Stripping, pages 313–316. Morgan Kaufmann Publishers Inc., San Francisco, CA, USA, 1997.
[21]
M. P. Robillard. What makes APIs hard to learn? Answers from developers. IEEE Software, 26(6):26–34, 2009.
[22]
M. P. Robillard and R. DeLine. A field study of api learning obstacles. Empirical Software Engineering, 16(6):703–732, 2011.
[23]
J. Singer, T. Lethbridge, N. Vinson, and N. Anquetil. An examination of software engineering work practices. In CASCON’97, page 21. IBM Press, 1997.
[24]
T. Vestdam. Generating Consistent Program Tutorials, pages 55–70. 2002.
[25]
R. Wallace, E. Soloway, J. Krajcik, N. Bos, J. Hoffman, H. E. Hunter, D. Kiskis, E. Klann, G. Peters, D. Richardson, and O. Ronen. Artemis: learner-centered design of an information seeking environment for k-12 education. In Proceedings of the SIGCHI Conference on Human Factors in Computing Systems, CHI ’98, pages 195–202, New York, NY, USA, 1998. ACM Press/Addison-Wesley Publishing Co.
[26]
S. Wasserman and K. Faust. Social network analysis: Methods and applications, volume 8. Cambridge university press, 1994.

Cited By

View all
  • (2024)NotePlayer: Engaging Computational Notebooks for Dynamic Presentation of Analytical ProcessesProceedings of the 37th Annual ACM Symposium on User Interface Software and Technology10.1145/3654777.3676410(1-20)Online publication date: 13-Oct-2024
  • (2024)Properties and Styles of Software Technology TutorialsIEEE Transactions on Software Engineering10.1109/TSE.2023.333256850:2(159-172)Online publication date: Feb-2024
  • (2021)How Do Developers Blog?ACM SIGSOFT Software Engineering Notes10.1145/3468744.346875346:3(26-29)Online publication date: 21-Jul-2021
  • Show More Cited By

Comments

Information & Contributors

Information

Published In

cover image ACM Conferences
MSR 2014: Proceedings of the 11th Working Conference on Mining Software Repositories
May 2014
427 pages
ISBN:9781450328630
DOI:10.1145/2597073
  • General Chair:
  • Premkumar Devanbu,
  • Program Chairs:
  • Sung Kim,
  • Martin Pinzger
Permission to make digital or hard copies of all or part of this work for personal or classroom use is granted without fee provided that copies are not made or distributed for profit or commercial advantage and that copies bear this notice and the full citation on the first page. Copyrights for components of this work owned by others than ACM must be honored. Abstracting with credit is permitted. To copy otherwise, or republish, to post on servers or to redistribute to lists, requires prior specific permission and/or a fee. Request permissions from [email protected]

Sponsors

In-Cooperation

  • TCSE: IEEE Computer Society's Tech. Council on Software Engin.

Publisher

Association for Computing Machinery

New York, NY, United States

Publication History

Published: 31 May 2014

Permissions

Request permissions for this article.

Check for updates

Author Tags

  1. Data mining
  2. Knowledge sharing
  3. Software documentation

Qualifiers

  • Article

Conference

ICSE '14
Sponsor:

Upcoming Conference

ICSE 2025

Contributors

Other Metrics

Bibliometrics & Citations

Bibliometrics

Article Metrics

  • Downloads (Last 12 months)20
  • Downloads (Last 6 weeks)4
Reflects downloads up to 06 Oct 2024

Other Metrics

Citations

Cited By

View all
  • (2024)NotePlayer: Engaging Computational Notebooks for Dynamic Presentation of Analytical ProcessesProceedings of the 37th Annual ACM Symposium on User Interface Software and Technology10.1145/3654777.3676410(1-20)Online publication date: 13-Oct-2024
  • (2024)Properties and Styles of Software Technology TutorialsIEEE Transactions on Software Engineering10.1109/TSE.2023.333256850:2(159-172)Online publication date: Feb-2024
  • (2021)How Do Developers Blog?ACM SIGSOFT Software Engineering Notes10.1145/3468744.346875346:3(26-29)Online publication date: 21-Jul-2021
  • (2021)Topic modeling in software engineering researchEmpirical Software Engineering10.1007/s10664-021-10026-026:6Online publication date: 6-Sep-2021
  • (2020)Automatically identifying valid API versions for software development tutorials on the WebJournal of Software: Evolution and Process10.1002/smr.222732:4Online publication date: 1-Apr-2020
  • (2019)A comparative study of FAQs for software developmentProceedings of the 2nd ACM SIGSOFT International Workshop on Software Qualities and Their Dependencies10.1145/3340495.3342750(8-11)Online publication date: 26-Aug-2019
  • (2019)Characterizing duplicate code snippets between stack overflow and tutorialsProceedings of the 16th International Conference on Mining Software Repositories10.1109/MSR.2019.00048(240-244)Online publication date: 26-May-2019
  • (2019)Categorizing the Content of GitHub README FilesEmpirical Software Engineering10.1007/s10664-018-9660-324:3(1296-1327)Online publication date: 1-Jun-2019
  • (2018)Development as a journey: factors supporting the adoption and use of software frameworksJournal of Software Engineering Research and Development10.1186/s40411-018-0050-86:1Online publication date: 4-Jun-2018
  • (2018)Natural language processing (NLP) applied on issue trackersProceedings of the 4th ACM SIGSOFT International Workshop on NLP for Software Engineering10.1145/3283812.3283825(38-41)Online publication date: 4-Nov-2018
  • Show More Cited By

View Options

Get Access

Login options

View options

PDF

View or Download as a PDF file.

PDF

eReader

View online with eReader.

eReader

Media

Figures

Other

Tables

Share

Share

Share this Publication link

Share on social media