On Jan 17, 2014 5:11 AM, "Leslie S Satenstein" <lsatenstein@xxxxxxxxx> wrote:
>
> This was the contents with attachment. If you cannot receive attachments, I will provide a link to the file via my Dropbox.
>
>
> Hi Guys, Pete
>
> I copied and pasted the draft from the web into a libreoffice document.
> Using markup management and comments that are standard with a word processor, I marked up the first six sections.
>
> I would continue, but before I spend a day or two more time, I would like feedback on what I did.
>
> If you are not familiar with markups and comments, here is a brief description.
> Turn on markups via the edit command. Every change to the document is identified and as well, a revision bar is written to the left margin.
> If there is a section of the document that needs clarification, highlight it and use the insert comment command to put a comment to the right side of the document, The comment and the highlighted text go together.
>
> For the person reviewing the changes.
> You can turn off markup,
> Now, as you pass through the document, you can accept or reject each change. Ditto for the comment. You can choose to leave it there or remove it.
> You could also continue with markups, marking up my changes or adding your own. Each set of markups will be identified by the person making them and with a timestamp.
>
> One could also click to select and accept all changes. That would result in a clean updated document which can be pasted back into the website.
>
> This iteration of markup, review, and redo typically takes three iterations and the result will be a superb document, easy to translate.
>
> Please review the attached and email me back with your changes or comments. Let me know if I should continue to the end of the guide.
>
>
> Thanks in advance
>
>
>
> Regards
>
> Leslie
>
> Regards
>
> Leslie
> Mr. Leslie Satenstein
> An experienced Information Technology specialist.
> Yesterday was a good day, today is a better day,
> and tomorrow will be even better.
> lsatenstein@xxxxxxxxx
> SENT FROM MY OPEN SOURCE LINUX SYSTEM.
>
Hi Leslie,
I did see your mail and attachment, but haven't had time to look it over yet. You sent that mail only to me, btw , not the list - you wanted reply-to-all I think :) Also, attachments will probably be rejected by the list, so it would be better to post a link to the file and best to just use the body of the email for your feedback.
While we are on the subject, have you given any consideration to using git and editing source like the rest of us? Frankly, your method creates a lot oof extra work for you and for me ( or whoever looks at your review ). I am well acquainted with your personal and professional history at this point, but I don't understand why you refuse to follow the established workflow. If you were to follow the git-branch-work-commit process, your changes would be readily apparent, your justification/comments would fit nicely in the commit message, and applying your changes would require *nearly zero effort* . If the suggested change is in an ODF, applying changes requires the additional step of manually editing the source. Then, we have to build and published the updated document for you to see any changes; that's a lot of extra work and you could just type `git pull` and save us from it.
I recently added a section to the documentation guide[1] on creating a patch using git. As someone with experience in a very different workflow, your review of *that* content[2] would be especially welcome.
[1] http://fedorapeople.org/groups/docs/docs-guide/sect-workflow-patching.html
[2] https://git.fedorahosted.org/cgit/docs/documentation-guide.git
--Pete
-- docs mailing list docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
