Our book about WordPress. Version 1

Overview

Milestones: The Story of WordPress

Welcome to the online repository for our book on the history and development of WordPress. This book is currently in version one.

Table of Contents

Feedback

The following feedback is particularly valuable:

  • Factual errors: notes about factual errors are welcome. All suggestions for changes should be evidenced with links that back up any claims. Any facts that cannot be corroborated will not be included.
  • Clarity: any paragraphs or sections that you feel are not clear. This would be of particular help in sections that are technical in nature.
  • Omissions: anything that you feel has been omitted or not sufficiently covered. Note that this is a lengthy piece of writing and many issues have to be condensed to ensure that it is a manageable and interesting read. Suggestions about omissions should be accompanied with information about why it should be included, and backed up with evidence as to their importance.
  • Images: if you have any images that you feel would complement the text, we'd love to have them.

All feedback should be opened as issues in the tracker.

Note: the interviews conducted as part of this project are available should you wish to reference anything or conduct your own research.

Translations

When the book is ready for production and no more changes are expected, we would welcome translations. To translate the book, please create a sub-directory of the project, giving it the correct ISO639 code (for example, pt for Portuguese), and submit a pull request.

License

The content has two licenses:

Just like WordPress, you are free to read, share, distribute, and modify the content however you want, passing on those freedoms to everyone else. Cool!

Comments
  • Link anchors are too long

    Link anchors are too long

    Finished epub version on my book reader and had bit of an issue with link anchors — they often covered whole area of screen where I tap to scroll. Paragraphs worth of a single link or consecutive links.

    opened by Rarst 6
  • i18n: ISO 639-X

    i18n: ISO 639-X

    There are several ISO639 levels. As lvl 3 is broken (inconsistent), lvl 5 is unfinished and lvl 1 only contains country codes, I'd recommend to change the README to use lvl 2. The ISO 639-2 uses language_COUNTRY codes and therefore fits for differences like German in Austria, Switzerland, Germany, etc. as well.

    opened by franz-josef-kaiser 6
  • The use of

    The use of "premium" versus "commercial" for themes.

    I'd like to propose that the book would be better served to reference paid themes as "commercial" versus "premium" wherever possible and still keep context.

    I know that some chapters, like chapter 29, refers to the "premium" theme marketing element, but within that chapter where it's not discussing the "premium" moniker itself, but labeling a theme shop, and in other chapters where it's simply labeling a theme shop as premium, the book would be better to showcase the themes as commercial instead.

    A couple of quick examples:

    Chapter 29:

    For designers and developers making free and premium themes, what distinguished them was the time and effort they put into them, and the level of effort required to set them up. In an interview in June 2008, premium theme developer Darren Hoyt talks about the differences between creating a free and a premium theme. He outlines his considerations:

    The second instance I think, at least, should say commercial, as it's descriptive of the real thing, not the practice of calling themes premium. The third makes sense as premium. The first is debatable...

    Chapter 31:

    Premium theme developers and the wider community were annoyed.

    and

    As the first to embrace the GPL, Brian Gardner advised other premium theme sellers.

    Both of these instances would be better served to say commercial, I believe. The middle of the chapter that explains Matt's stance on "Premium", "Proprietary", and other labels is more difficult to determine appropriate labeling.

    In general, I'd love to see the book notate commercial instead of premium when describing themes that cost money. Of course, this requires balance with the common terminology that was used during that period and now, where appropriate.

    I completely trust Siobhan's ability to make that balance, but would at least like to review the usage of the word "premium" throughout the book to see if it can or should be replaced with more accurate terminology.

    opened by krogsgard 5
  • BDFL examples

    BDFL examples

    Hi! Trying to avoid spoiling too much of the book, but couldn't resist reading a few select chapters. :)

    In Part 3/24-habari.md, it contains the following:

    Notable BDFLs are Linus Torvalds of Linux and Rasmus Lerdorf of PHP.

    However, Rasmus doesn't actually hold the title of BDFL, as PHP's decision-making process is consensus based. A much better example would be Guido van Rossum of Python, for whom the term was originally created (citation).

    Note that the above Wikipedia article does claim that Rasmus is the BDFL, although it sites a secondary source with no verification for the claim. Van Rossum's claim has many more documents to support it, including an article written by him talking about the history of the title, and an entry in the Jargon File.

    opened by rmccue 3
  • Explanation of terminology for 'ping' in Chapter 1

    Explanation of terminology for 'ping' in Chapter 1

    I'm not sure whether you think it's necessary or not, but where you're explaining what a permalink and trackback are, you use the term ping (also jargon in this context) without explanation.

    I would think if someone didn't know what a permalink or trackback was, they also won't understand what a ping is.

    opened by Japh 3
  • Improve markup for interviewees.md

    Improve markup for interviewees.md

    • Fix Community -> To Contact subheading not displaying correctly.
    • Change italic subheadings to proper headings for semantics, automatic page anchors and to make it easier to scan.
    opened by GaryJones 2
  • Odd image cropping...

    Odd image cropping...

    The image -- https://github.com/WordPress/book/blob/master/Resources/images/44/post-formats.jpg -- may be better off cropped just a few pixels shorter. The side meta box currently just shows a line at the bottom of the image where the next meta box would stop, and it feels a bit awkward.

    image

    opened by georgestephanis 2
  • The licenses may not be compatible

    The licenses may not be compatible

    I don't think GPLv2 is compatible with Creative Commons Sharealike license.

    As far as I know the only CC license that is GPL compatible is CC0

    From Gnu GPL:

    Creative Commons Attribution-Sharealike 2.0 license This is a copyleft free license that is good for artistic and entertainment works, and educational works. Please don't use it for software or documentation, since it is incompatible with the GNU GPL and with the GNU FDL.

    My 2¢..license compatibility is pretty confusing considering.. it's a book on github which might be considered software.

    opened by wycks 2
  • Correct minor typos, adjust paragraphs, reword several sentences for hello-world.md

    Correct minor typos, adjust paragraphs, reword several sentences for hello-world.md

    I enjoyed reading the first part of the WordPress book and would like to propose the following changes. Let me know what you think and thank you for your work.

    opened by pmciano 1
  • Release Leads

    Release Leads

    I can't find anywhere that lists all of the release leads for each version since WP transitioned to release leads.

    https://make.wordpress.org/core/tag/release-lead/

    Could they be added to the relevant chapter or an appendix?

    opened by GaryJones 1
  • Is the book

    Is the book "to be continued..."?

    Hi! Seeing that the Story of WordPress is still being written, are there any plans to have a sequel or append to the current story? ps: I just read the part about The WordPress Foundation, and found it very insightful! 😃

    opened by ghost 1
  • ePub Doesn't work with Google Play Books

    ePub Doesn't work with Google Play Books

    I tried uploading to Google Play Books and it says "file cannot be processed." then has a "learn more" option taking me to this page: https://support.google.com/googleplay/answer/3097151?visit_id=636829228570910203-3019479125&rd=1

    Something about the formatting (I assume) of the ePub isn't allowing it to be added there. Would be nice if it worked.

    opened by tevyaw 0
  • How to cite this book?

    How to cite this book?

    I'm writing a master's thesis about WordPress, and it is unclear to me how to cite this book. Specifically, what is the author? Was it first released in 2015? Maybe this information could be added to the book itself? Thanks.

    opened by rodrigoprimo 0
Owner
null
A plugin to disable the drop cap option in Gutenberg editor paragraph block. This is version 2.

Disable Drop Cap (v2) A plugin to disable drop cap option in the Gutenberg editor block editor paragraph block. Note for WordPress 5.8 With WordPress

Johannes Siipola 4 Jan 4, 2022
A custom WordPress nav walker class to fully implement the Twitter Bootstrap 4.0+ navigation style (v3-branch available for Bootstrap 3) in a custom theme using the WordPress built in menu manager.

WP Bootstrap Navwalker This code in the main repo branch is undergoing a big shakeup to bring it in line with recent standards and to merge and test t

WP Bootstrap 3.3k Jan 5, 2023
A curated list of Awesome WordPress Theme, Plugins and Framework development Resources and WordPress Communities.

Awesome WordPress A curated list of Awesome WordPress Theme, Plugins and Framework development Resources and WordPress Communities. Inspired by bayand

Dropndot Limited 91 Dec 26, 2022
The Pronamic WordPress Basecone plugin allows you to connect your WordPress installation to Basecone.

Pronamic WordPress Basecone The Pronamic WordPress Basecone plugin allows you to connect your WordPress installation to Basecone. Table of contents Au

Pronamic 1 Oct 19, 2021
A WordPress plugin to suspend WordPress sites automagically. Simple and lightweight, no annoying ads and fancy settings.

Suspend WP A WordPress plugin to suspend WordPress sites automagically. Simple and lightweight, no annoying ads and fancy settings. ?? Demo (coming so

Waren Gonzaga 3 Nov 15, 2021
Twenty Twenty-Two, the default WordPress theme that will launch with WordPress 5.9.

Twenty Twenty-Two Welcome to the development repository for the default theme that will launch with WordPress 5.9. About Twenty Twenty-Two is designed

null 414 Nov 28, 2022
Easy handle APlayer on WordPress. A shortcode for WordPress to using APlayer.

Description Easy handle APlayer on WordPress. A shortcode for WordPress to using APlayer. Support [audio] tag, compatible with AMP. Requirement WordPr

Karl Chen 24 Nov 3, 2022
WordPress plugin that lets you use Discourse as the community engine for a WordPress blog

WP Discourse Note: the wp-discourse plugin requires >= PHP-5.4.0. The WP Discourse plugin acts as an interface between your WordPress site and your Di

Discourse 497 Dec 10, 2022
WordPress & TypeScript. Simple starter template for WordPress projects

WordPress & TypeScript. Simple starter template for WordPress projects that want to use TypeScript in combination with @wordpress/scripts

Make it WorkPress 11 Sep 27, 2022
Simple WordPress plugin to learn how to understand WordPress Crons and the Action Scheduler library.

Simple WordPress plugin to learn how to understand WordPress Crons and the Action Scheduler library. Import Jamendo playlists with tracks in WordPress posts.

Pierre Saikali 3 Dec 7, 2022
A PHP client for Wordpress websites that closely implement the XML-RPC WordPress API

Wordpress XML-RPC PHP Client A PHP client for Wordpress websites that closely implement the XML-RPC WordPress API Created by Hieu Le MIT licensed. Cur

Hieu Le 112 Nov 10, 2022
Automattic 10.7k Jan 2, 2023
WordPress Framework based on parent theme

Cherry Framework The most delicious WordPress framework Fully responsive design, easy install, steady updates, great number of shortcodes and widgets,

Cherry Framework 158 Nov 23, 2022
A better way to create WordPress themes.

Runway Framework for WordPress Visit the Runway website: RunwayWP.com A better way to create WordPress themes. Runway was built for creating WordPress

Parallelus 214 Nov 18, 2022
The easiest to use WordPress option framework.

Titan Framework The easiest to use WordPress options framework. Titan Framework allows theme and plugin developers to create admin pages, options, met

Gambit Technologies 374 Nov 14, 2022
🚀WordPress Plugin Boilerplate using modern web techs like TypeScript, SASS, and so on... on top of a local development environment with Docker and predefined GitLab CI for continous integration and deployment!

WP React Starter: WordPress React Boilerplate DEPRECATED: WP React Starter was a "research project" of devowl.io for the development of our WordPress

devowl.io GmbH 344 Jan 1, 2023
📦 A zero-configuration #0CJS developer toolkit for building WordPress Gutenberg block plugins.

create-guten-block is zero configuration dev-toolkit (#0CJS) to develop WordPress Gutenberg blocks in a matter of minutes without configuring React, w

Ahmad Awais ⚡️ 3.1k Dec 23, 2022
Examples for extending WordPress/Gutenberg with blocks.

Gutenberg Examples Examples for extending Gutenberg with plugins which create blocks. See also: Gutenberg developer documentation Installation Gutenbe

null 1.1k Dec 29, 2022
Documents WordPress Classic Editor integration points and their Gutenberg equivalents

Gutenberg Migration Guide This repository documents WordPress Classic Editor customization points and their Gutenberg equivalents (if such exist). Its

Daniel Bachhuber 185 Nov 16, 2022