* Issues with EDK-II-Debugging wiki page, and how to submit a pull request for wiki pages @ 2019-02-14 17:39 Rebecca Cran 2019-02-14 19:23 ` Laszlo Ersek 0 siblings, 1 reply; 5+ messages in thread From: Rebecca Cran @ 2019-02-14 17:39 UTC (permalink / raw) To: edk2-devel I noticed a couple of issues with the page https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Debugging - 'SNI' should be 'SNP', and the |PcdDebugPrintErrorLevel is missing some entries. | How do I fork the wiki repo to make a pull request? On each page there's a "Clone this wiki locally" box where I can clone https://github.com/tianocore/tianocore.github.io.wiki.git, but when I try and fork it I instead fork https://github.com/tianocore/tianocore.github.io which doesn't have the same files either on the master or gh-pages branches - it looks like https://github.com/tianocore/tianocore.github.io has the files for www.tianocore.org, not the wiki? -- Rebecca Cran ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Issues with EDK-II-Debugging wiki page, and how to submit a pull request for wiki pages 2019-02-14 17:39 Issues with EDK-II-Debugging wiki page, and how to submit a pull request for wiki pages Rebecca Cran @ 2019-02-14 19:23 ` Laszlo Ersek 2019-02-20 7:45 ` Rebecca Cran 0 siblings, 1 reply; 5+ messages in thread From: Laszlo Ersek @ 2019-02-14 19:23 UTC (permalink / raw) To: Rebecca Cran; +Cc: edk2-devel On 02/14/19 18:39, Rebecca Cran via edk2-devel wrote: > I noticed a couple of issues with the page > https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Debugging - > 'SNI' should be 'SNP', and the |PcdDebugPrintErrorLevel is missing some > entries. > | > > > How do I fork the wiki repo to make a pull request? I suggest the following: (1) clone the wiki to your local workstation. The repo URL is git://github.com/tianocore/tianocore.github.io.wiki (2) In any project that you have *on github*, enable the wiki (specific to that project). Then, add *that* wiki as a "remote" to your local clone that was made in step (1): [remote "mine"] url = git@github.com:GITHUB_USERNAME/PROJECT.wiki.git tagopt = --no-tags The command I recommend is git remote add --no-tags mine \ git@github.com:GITHUB_USERNAME/PROJECT.wiki.git (3) You can develop wiki article changes in your local repo, on a dedicated topic branch. Simply commit and rebase as you see fit. (4) For rendering your local changes, force-push your local topic branch to the master branch of your own wiki: git push --force mine TOPIC_BRANCH:master Then, if you refresh your own wiki page, on github, in your browser, you should see the changes. Please note that this step is destructive, with regard to the personal wiki that you push to. In addition, IIRC, this step requires SSH pubkey auth to be enabled in your github profile. (Step 2 could require it too; I'm not certain.) (5) Once you are done with development, simply format the patches as usual, and submit them to edk2-devel with git-send-email. For formatting, use the parameter --subject-prefix='edk2-wiki PATCH' This will tell reviewers the patches are for the wiki. I can help apply the changes when they are suitably reviewed. I'm not sure if we have designated maintainers/reviewers for wiki pages. Usually there is a related area in edk2, so I guess the edk2 maintainer(s) could double in the docs reviewer role too. > On each page there's > a "Clone this wiki locally" box where I can clone > https://github.com/tianocore/tianocore.github.io.wiki.git, but when I > try and fork it I instead fork > https://github.com/tianocore/tianocore.github.io which doesn't have the > same files either on the master or gh-pages branches - it looks like > https://github.com/tianocore/tianocore.github.io has the files for > www.tianocore.org, not the wiki? The wikis on github are non-intuitive, if you intend to edit them in a normal text editor, locally. I struggled a lot until I came up with the list on top. (It's possible I relied on others' advice in that; I no longer remember.) I hope it helps. Thanks, Laszlo ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Issues with EDK-II-Debugging wiki page, and how to submit a pull request for wiki pages 2019-02-14 19:23 ` Laszlo Ersek @ 2019-02-20 7:45 ` Rebecca Cran 2019-02-20 9:51 ` Laszlo Ersek 0 siblings, 1 reply; 5+ messages in thread From: Rebecca Cran @ 2019-02-20 7:45 UTC (permalink / raw) To: Laszlo Ersek; +Cc: edk2-devel On Thursday, 14 February 2019 12:23:05 MST Laszlo Ersek wrote: > The wikis on github are non-intuitive, if you intend to edit them in a > normal text editor, locally. I struggled a lot until I came up with the > list on top. (It's possible I relied on others' advice in that; I no > longer remember.) I hope it helps. Yeah, thanks but no thanks. I'm not _that_ keen on making my changes if it's going to involve all that work! -- Rebecca Cran ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Issues with EDK-II-Debugging wiki page, and how to submit a pull request for wiki pages 2019-02-20 7:45 ` Rebecca Cran @ 2019-02-20 9:51 ` Laszlo Ersek 2019-02-20 15:00 ` Gao, Liming 0 siblings, 1 reply; 5+ messages in thread From: Laszlo Ersek @ 2019-02-20 9:51 UTC (permalink / raw) To: Rebecca Cran, Michael Kinney; +Cc: edk2-devel On 02/20/19 08:45, Rebecca Cran wrote: > On Thursday, 14 February 2019 12:23:05 MST Laszlo Ersek wrote: > >> The wikis on github are non-intuitive, if you intend to edit them in a >> normal text editor, locally. I struggled a lot until I came up with the >> list on top. (It's possible I relied on others' advice in that; I no >> longer remember.) I hope it helps. > > Yeah, thanks but no thanks. I'm not _that_ keen on making my changes if it's > going to involve all that work! > Totally understandable. I *think* it should be possible to simply edit the wiki articles with github's built-in wiki editor too, but I have no clue about the credentials needed. Perhaps being a member of the <https://github.com/tianocore-docs> organization suffices; I'm not certain. Mike, can you please comment? What's the best process for wiki edits? Thanks, Laszlo ^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Issues with EDK-II-Debugging wiki page, and how to submit a pull request for wiki pages 2019-02-20 9:51 ` Laszlo Ersek @ 2019-02-20 15:00 ` Gao, Liming 0 siblings, 0 replies; 5+ messages in thread From: Gao, Liming @ 2019-02-20 15:00 UTC (permalink / raw) To: Laszlo Ersek, Rebecca Cran, Kinney, Michael D; +Cc: edk2-devel Laszlo: I mostly use local editor to edit wiki and send the patch. This way can't see the preview wiki page in web. It may cause the mistake. Thanks Liming > -----Original Message----- > From: edk2-devel [mailto:edk2-devel-bounces@lists.01.org] On Behalf Of Laszlo Ersek > Sent: Wednesday, February 20, 2019 5:52 PM > To: Rebecca Cran <rebecca@bluestop.org>; Kinney, Michael D <michael.d.kinney@intel.com> > Cc: edk2-devel <edk2-devel@lists.01.org> > Subject: Re: [edk2] Issues with EDK-II-Debugging wiki page, and how to submit a pull request for wiki pages > > On 02/20/19 08:45, Rebecca Cran wrote: > > On Thursday, 14 February 2019 12:23:05 MST Laszlo Ersek wrote: > > > >> The wikis on github are non-intuitive, if you intend to edit them in a > >> normal text editor, locally. I struggled a lot until I came up with the > >> list on top. (It's possible I relied on others' advice in that; I no > >> longer remember.) I hope it helps. > > > > Yeah, thanks but no thanks. I'm not _that_ keen on making my changes if it's > > going to involve all that work! > > > > Totally understandable. I *think* it should be possible to simply edit > the wiki articles with github's built-in wiki editor too, but I have no > clue about the credentials needed. Perhaps being a member of the > <https://github.com/tianocore-docs> organization suffices; I'm not certain. > > Mike, can you please comment? What's the best process for wiki edits? > > Thanks, > Laszlo > _______________________________________________ > edk2-devel mailing list > edk2-devel@lists.01.org > https://lists.01.org/mailman/listinfo/edk2-devel ^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2019-02-20 15:00 UTC | newest] Thread overview: 5+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2019-02-14 17:39 Issues with EDK-II-Debugging wiki page, and how to submit a pull request for wiki pages Rebecca Cran 2019-02-14 19:23 ` Laszlo Ersek 2019-02-20 7:45 ` Rebecca Cran 2019-02-20 9:51 ` Laszlo Ersek 2019-02-20 15:00 ` Gao, Liming
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox