diff --git a/docs/_quarto.yml b/docs/_quarto.yml index 3a557d6..8b4f062 100644 --- a/docs/_quarto.yml +++ b/docs/_quarto.yml @@ -2,14 +2,14 @@ project: type: book output-dir: "_build" # '_book' by default preview: - port: 4567 + port: 3244 browser: true # https://quarto.org/docs/books/ # https://quarto.org/docs/reference/projects/books.html book: - title: "My Book" - author: "Norah Jones" + title: "Management of Software Development in Python" + author: "Michael J Rossetti" date: "last-modified" # "7/24/2024" date-format: "iso" #doi: "...." @@ -20,14 +20,14 @@ book: # https://quarto.org/docs/websites/website-tools.html#google-analytics #google-analytics: "G-..." - site-url: https://s2t2.github.io/quarto-book-template/ - repo-url: https://github.com/s2t2/quarto-book-template + repo-url: https://github.com/prof-rossetti/mgmt-software-dev-python-book/ + site-url: https://prof-rossetti.github.io/mgmt-software-dev-python-book/ repo-branch: main repo-subdir: docs repo-actions: [edit, issue, source] downloads: [pdf, epub, docx] - sharing: [twitter, facebook] + #sharing: [twitter, facebook] # https://quarto.org/docs/websites/website-tools.html#open-graph open-graph: true @@ -36,12 +36,12 @@ book: #location: sidebar # navbar, sidebar #type: textbox # overlay, textbox - cover-image: assets/images/cover.png + #cover-image: assets/images/startup.png #favicon: assets/images/favicon.ico # https://quarto.org/docs/websites/website-navigation.html#side-navigation sidebar: - logo: assets/images/quarto-dark-bg.jpeg + logo: assets/images/startup.png #title: false # doesn't work? (see custom CSS in styles.css to hide) #tools: # #- icon: twitter @@ -55,23 +55,24 @@ book: chapters: - index.qmd - - intro.qmd + #- why-python.qmd - - part: "Part I" - #href: part-1/index.qmd - chapters: - - part-1/chap-1.qmd - - part-1/chap-2.qmd + #- part: "Part I" + # #href: part-1/index.qmd + # chapters: + # - part-1/chap-1.qmd + # - part-1/chap-2.qmd #- part: "Part II" - # #href: part-2/index.qmd # chapters: # - part-2/chap-3.qmd # - part-2/chap-4.qmd - - summary.qmd - - references.qmd + #- summary.qmd + #- references.qmd + - "------------" + - about-author.qmd # shows up at bottom of page #body-footer: "© Copyright 2024, Your Name Here" diff --git a/docs/about-author.qmd b/docs/about-author.qmd new file mode 100644 index 0000000..a7b1b15 --- /dev/null +++ b/docs/about-author.qmd @@ -0,0 +1,21 @@ +# About the Author {.unnumbered} + +Michael Rossetti is a data scientist and software engineer. He has worked as a data analyst for a winning US Presidential campaign, an analytics director for a Silicon Valley startup, and a technology consultant for the US Government. + +As an adjunct professor, he has taught courses in data science, computer science, and software development at universities including New York University, Georgetown University, and the George Washington University. + +He has honed and adapted his Python educational materials based on lessons learned from teaching Python programming to thousands of students over the past decade. + +## More Information + +Academic Website: + + +Connect on LinkedIn: + + +Follow on GitHub: + + +Subscribe on YouTube: + diff --git a/docs/assets/images/startup.png b/docs/assets/images/startup.png new file mode 100644 index 0000000..6ef111a Binary files /dev/null and b/docs/assets/images/startup.png differ diff --git a/docs/index.qmd b/docs/index.qmd index 2062215..808cc57 100644 --- a/docs/index.qmd +++ b/docs/index.qmd @@ -1,5 +1,29 @@ -# Preface {.unnumbered} -This is a Quarto book. +# Welcome {.unnumbered} -To learn more about Quarto books visit . +![](../assets/images/startup.png){fig-align="center" fig-alt="Management of Software Development in Python (banner image)"} + +Welcome to the \"Management of Software Development in Python\" book (2024 edition, online)! + +This book will introduce you to software development tools and best practices, tailored specifically for business students, professionals, and aspiring entrepreneurs. Whether you're looking to gain a better understanding of how to manage the software development process, communicate effectively with technical teams, or take the lead on a tech-driven project, this book is designed to equip you with the essential skills and knowledge. + +In today's fast-paced business environment, having a solid grasp of technical concepts is crucial. This book will empower you to speak the language of developers, manage technical teams with confidence, and even bring your own innovative ideas to life by creating prototype applications that could serve as the foundation for a startup. + +Throughout this book, we'll cover key units designed to build your competence and confidence in software development: + +1. **Local Development Tools** – Learn how to install and configure Python development tools on your local machine, setting the stage for effective coding practices. + +2. **Version Control** – Master the essentials of version control to track changes, collaborate efficiently, and maintain the integrity of your projects. + +3. **Code Organization, Simplification, and Refactoring** – Understand the principles of clean code, making your projects easier to manage, extend, and scale. + +4. **Automated Testing and Continuous Integration** – Explore the practices that ensure your code is reliable, maintainable, and ready for deployment at any time. + +5. **Software Products and Services** – Dive into the process of building web applications and deploying them to user-facing production environments, bringing your ideas to life. + + +This book isn't about learning to code - it assumes you already have an introductory level working knowledge in Python programming. If you need to brush up on Python programming first, check out the [Intro to Python Programming book](https://prof-rossetti.github.io/intro-software-dev-python-book) and gain practice programming in Python Notebooks, then come back here afterwards. + +By the end of this journey, you'll be equipped to manage software development processes, lead technical teams, and perhaps even turn your entrepreneurial ideas into reality. + +Let’s get started! diff --git a/docs/part-1/chap-1.qmd b/docs/part-1/chap-1.qmd deleted file mode 100644 index 110775b..0000000 --- a/docs/part-1/chap-1.qmd +++ /dev/null @@ -1,5 +0,0 @@ -# Chapter 1 - -This is a chapter. - -We can't go any lower than chapter level. diff --git a/docs/part-1/chap-2.qmd b/docs/part-1/chap-2.qmd deleted file mode 100644 index ca09a81..0000000 --- a/docs/part-1/chap-2.qmd +++ /dev/null @@ -1,7 +0,0 @@ -# Chapter 2 - -This is another chapter. - -This is an image: - -![an example image](/assets/images/quarto-dark-bg.jpeg) diff --git a/docs/part-1/index.qmd b/docs/part-1/index.qmd deleted file mode 100644 index 6a7c2f8..0000000 --- a/docs/part-1/index.qmd +++ /dev/null @@ -1,3 +0,0 @@ -# Part 1 - -This is an index. diff --git a/docs/summary.qmd b/docs/summary.qmd deleted file mode 100644 index f8e63e0..0000000 --- a/docs/summary.qmd +++ /dev/null @@ -1,25 +0,0 @@ -# Summary {.unnumbered} - -In summary, this book has no content whatsoever. - -Here are some [call outs](https://quarto.org/docs/authoring/callouts.html). - -::: {.callout-note} -Note that there are five types of callouts, including: `note`, `warning`, `important`, `tip`, and `caution`. -::: - -::: {.callout-warning} -This is a callout. -::: - -::: {.callout-important} -This is a callout. -::: - -::: {.callout-tip} -This is a callout. -::: - -::: {.callout-tip title="Tip with Title"} -This should be an example of a callout with a caption. So add a caption! -:::