Re: Can you help me out with integrating editing to the docs It will take you 8,77 minutes to follow.

Adam Samalik <asamalik@xxxxxxxxxx> · Wed, 22 Aug 2018 19:10:22 +0200

I've done a Fedora Classroom recently, covering the basics, incuding git and a complete workflow. Recording: https://m.youtube.com/watch?v=LkH2ugg49Ag

Happy to do even a more detailed one, including installation and setting up git, generating a key and adding it to Pagure, and whatever else is needed. Would that be helpful?

On Wed, 22 Aug 2018 at 18:58, Richard England <pdx.limey@xxxxxxxxx> wrote:

    Would it be possible to create a video
      of or for this lesson so it can be shared later?

      I, too, am finding the editing process difficult to get into.

      On 08/22/2018 04:48 AM, Adam Samalik wrote:

      Hi Leslie,

        I really value your work and I'd really like to help you to
          integrate it. But rather than doing the integration work
          myself (for which, to be fair, I don't have many spare
          cycles), I'd like to teach you how to do it yourself. The
          benefits would be:

        * The integration of your work wouldn't generate additional
          work for other people, other than the actual review + feedback
        * You would be able to get feedback in the PR itself —
          there is a space for discussion, as well as posting inline
          comments
        * Many different people could help with commenting,
          reviewing, and even merging the changes
        * You would get credit as those changes would be clearly
          marked as yours

        I'd rather spent an hour teaching you how to do future
          changes yourself, rather than doing it myself for 8.77
          minutes. Especially with the amount of work you do, I wouldn't
          be able to keep up long-term. Also, there are many other
          people out there that could help to review the changes.

        I know, git might be a new tool for many writers, and
          learning it might require some effort, but using it has many
          benefits for large communities such as Fedora, where we need
          to scale our work between many people living in different
          parts of the world and different timezones. If we want to work
          in a large community, or want to build a large community, we
          need to have workflows that scale. And git is one of the least
          horrible options there.

        So, I'm happy to have a video call with you, even for an
          hour, going through the integration of your changes, so you
          feel comfortable doing them yourself next time. Would that
          work for you?

        Please let me know.

        regards,
        Adam

        On Mon, Aug 20, 2018 at 5:43 PM Leslie S
          Satenstein <lsatenstein@xxxxxxxxx> wrote:

                  Hi Adam,

                  Your response will go a long way to
                      understanding what I mean and do by "editing"

                  Can you help me out with integrating
                      editing to the *.adocs?

                  What I have attached is one fairly short
                    libreoffice writer document  (1.5 pages)  and the
                    corresponding updated Desktop.adoc. 

                  Before I can generate a pull request, I made a
                    correction and asked some questions inside the
                    libreoffice writer file.  Those questions, if
                    properly responded to, are to be the modifications
                    to be made to the corresponding *.adoc file. A third
                    x.sh file  just invokes vim against the location to
                    where the  target adoc file resides.

                  I am and attaching a zip file with the updated
                    Desktop.adoc and the corresponding libreoffice 
                    "Desktop.adoc.odt".  The way I see things working,
                    the libreoffice document is the working document.
                    When it is clean, the contents therein are what is
                    transfered to the corresponding *.adoc file and a PR
                    sent.

                  2) Can you please note. Not all document writers
                    are git users.  They are writers, and can follow
                    instructions. Please add a definition of a Pull
                    Request.

                  Pull Request:  A formal request document,
                    transmitted to the owner of the git repository. The
                    PR contains revisions or insertions that you are
                    requesting for that git repository.

                                  Regards

                                       Leslie

                                  Leslie Satenstein

                                  Montréal
                                      Québec, Canada

      -- 

                  Adam Šamalík

                  ---------------------------

              Software
                Engineer

                Red Hat

      _______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx/message/MUZ6533QHMBY5SH6NPKGQUE6ZP4NCX72/

-- 

Adam Šamalík
---------------------------
Software Engineer
Red Hat

_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx/message/K76FBAEPCNWJAS3PROLB6HF57XJ4V7RO/