durabledrupal / awebfactory-content-migration-rescue Goto Github PK

The exisiting Intro is for technical readers (developers on up). Could be the technical team of a client or members of the Drupal Community, etc.

We need to structure the Intro, putting in first place a non-technical part, then a technical part.

In the paragraph of line 60 in Chapter 03 there is a reference of a year which needs clarification:

Which comes simply from software development best practices, and "Content Model" should cease being considered a rockstar buzzword, and certainly was not invented by anyone in 2013. NPR in 2009 make reference to the same kind of structure as part of their famous "COPE" (Create Once, Publish Everywhere) which we mentioned in an earlier chapter, and which inspires us all.

There is no mention in the whole chapter of that date before... The only other mention is in the previous chapter (02) but is a hyperlink to other place which states:
2013 - Daniel Jacobson and Jeff Eaton on NPR's COPE and Content APIs

Only a person which is reading the online version and eventually followed that link in the previous chapter may understand the meaning of "certanily was not invented on 2013". But if you have, let say, a printed version of the book, that reference will remain obscure.

Possible solutions:

• Add a short quote below the link in chapter 2, like many other linked references, that summarize the meaning of that year in the history timeline... and put a link to that part of chapter 2 in the paragraph, along with the reference to COPE.
• Add the short quote referencing that date inside the paragraph itself, or may be as a footnote (which is still a good hyperlink-like solution for physical books :)
• Remove the obscure reference of the un-invention in 2013 of the paragraph or add some sentences before to re-create the history-timeline context.

• Fork repo
• Review build system (not necessary to do PDF, HTML is sufficient to check on translation formatting
• Create working branch
• Work in /manuscripts/es/... and output to /_preview/en/...
• Push ongoing work to your own forked repo working branch
• When ready, perform pull request to this repo from your pushed working branch.

The link to the image migration01.png, at the beginning of the Charapter 3 gives a 404

https://github.com/DurableDrupal/awebfactory-content-migration-rescue/blob/master/manuscript/en/img/migration01.png

This one works (at least if you are reading the online version of the document

https://raw.githubusercontent.com/DurableDrupal/awebfactory-content-migration-rescue/master/img/migration01.png

Is the url working when you create the PDFs and ePubs?
In that case, is there a way to have an URL that will work for reading online and also for the pandoc build proccess?

In the line 9 there is a sentence which enumerates 3 things using "and" two times (instead of a comma)

"filterable by business goals and audience interests and goals."

Could be:

filterable by business goals, audience interests and goals.

or if you mean only two options, then

filterable by business goals or audience interests and goals.

Using cursive to consolidate the two entities