aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLeah Rowe <info@minifree.org>2017-04-08 16:14:53 +0100
committerLeah Rowe <info@minifree.org>2017-04-08 16:14:53 +0100
commitdb5a75c817dd4210af61d62c1082ddd3967770c5 (patch)
treea4cf4e2916f96184b8857dff671d2b794047d954
parent166686776789fa7b0035d8e6e45ade8700e553ba (diff)
downloadlibrebootfr-db5a75c817dd4210af61d62c1082ddd3967770c5.tar.gz
librebootfr-db5a75c817dd4210af61d62c1082ddd3967770c5.zip
Vastly improve the Git page
-rw-r--r--www/git.md124
-rw-r--r--www/index.md2
2 files changed, 31 insertions, 95 deletions
diff --git a/www/git.md b/www/git.md
index 043021f4..07852959 100644
--- a/www/git.md
+++ b/www/git.md
@@ -4,98 +4,40 @@ x-toc-enable: true
...
Useful information, related to Libreboot development, including links to the
-Git repositories where development is done. Developments within Libreboot are
-discussed on the
-[IRC channel](https://webchat.freenode.net/?channels=libreboot).
+Git repositories where development is done. Libreboot development is discussed
+on the [IRC channel](https://webchat.freenode.net/?channels=libreboot).
Download Libreboot from the Git repository here:
**git clone https://notabug.org/libreboot/libreboot.git**
-How can I help the libreboot project?
---------------------------------------
-
-**At any given time, here is a list of tasks if there are any, for the
-next stable release of libreboot:
-[click here](https://notabug.org/libreboot/libreboot/issues)** - this is
-also where to send bug reports.
-
-There are many ways that you can assist the libreboot project. We have a
-[task list on the bug tracker](https://notabug.org/libreboot/libreboot/issues),
-which you can work
-on (you can also add to that list). Generally speaking, adding support
-for more hardware is a priority for the libreboot project. Information
-about building libreboot can be found at [here](docs/git/).
-
-We especially need more skilled coreboot hackers to do work that will
-benefit the libreboot project. This includes porting new boards to
-coreboot, which are likely to be valid candidates for libreboot.
-
-Learn libreboot from the inside out; download the git repository, and
-study libreboot. We need more full-time developers who can help to
-maintain the project.
-
-Not a developer? You can still help!
-
-- Work towards convincing hardware manufacturers and designers to
- start caring about free software. Perhaps even build your own
- hardware.
-
-- Spread the word about libreboot! Tell your friends about it, and
- talk about it on public internet-based discussion networks (e.g.
- *social networks*).
-- Install and use libreboot yourself, showing it to others and
- promoting it that way. [Computers with libreboot preinstalled are
- also available](suppliers.md), which helps to fund the libreboot
- project.
-- Help others to install libreboot. For example, organize an
- installation workshop at your local hackerspace.
-- Assist with improving the libreboot documentation, so that others
- may find it easier to use.
-
General guidelines for submitting patches
-----------------------------------------
-Some people put their name on their work, for recognition, and it's OK
-if you want to do that; however, the libreboot project does not require
-this. Some projects (such as coreboot) require a legal name, and this
-can be problematic for certain groups of people.
-
-Using your legal name is **not** required when submitting patches to
-libreboot. For reasons why we have this policy, read [this
-article](http://geekfeminism.org/2012/09/29/quick-hit-how-git-shows-the-patriarchal-nature-of-the-software-industry/).
-You can use any name of your choosing, or your company name (if you have
-one), if you want or need to do that. You can also submit patches
-*without a name*, if you want or need to do that (instructions are
-provided on this page). Also, read [this
-article](http://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/).
-Unfortunately, git appears to be stuck with these problems, when an
-author changes their name, and we don't have a concrete answer to it.
-As far as we know, publishing your legal name isn't even required for
-copyright purposes; in fact, "pen" names are commonly used by literary
-authors (computer programs are literary works).
-
-When submitting any kind of documentation, try not to use the terms
-him/her, she/he, his/her, or anything that is gender biased. **Use
-their, they, them, those people, that person, and so on.** [You are making a
-huge
-difference](https://gist.github.com/0xabad1dea/8870b192fd1758743f66#file-singularthey-md)
-
-<https://www.gnu.org/licenses/license-list.html>. NOTE: not
-putting a copyright notice on a work does not mean it lacks copyright.
-Copyright is *automatic* in most countries. Not putting a license on a
-work also does not make that work *free*; you have to declare a free
-license, otherwise the default, restrictive copyright laws apply for
-those who wish to do anything with your work. Always put a license on
-your work!
+We require all patches to be submitted under a free license:
+<https://www.gnu.org/licenses/license-list.html>.
+
+You *must* declare copyright on your work, and declare a free license. Not
+declaring copyright, especially if you also don't declare a license, means that
+the default restrictive copyright laws apply under the Berne convention.
+
+If you wish to submit work without copyright, or with permissive terms, then
+the *Creative Commons Zero* license is highly recommended. Otherwise, the **GNU
+General Public License, version 3 or (at your option) any later version**, is
+preferred; we will also accept any other free license.
Libreboot development is facilitated by *[git](https://git-scm.com/)*, a
-*distributed* version control system. You will need to install git (most
-distributions package it in their repositories).
+*distributed* version control system. You will need to install Git (most
+GNU+Linux distributions package it in their repositories).
+
+GNU+Linux is generally recommended as the OS of choice, for Libreboot
+development.
How to download Libreboot from the Git repository
-------------------------------------------------
+In your terminal:
+
**git clone https://notabug.org/libreboot/libreboot.git**
A new directory named ***libreboot*** will have been created, containing
@@ -104,25 +46,19 @@ libreboot.
How to submit your patches
--------------------------
-### Method 0: Use NotABug pull requests
+Make an account on <https://notabug.org/> and navigate (while logged in) to
+<https://notabug.org/libreboot/libreboot>. Click *Fork* and in your account,
+you will have your own repository of Libreboot. Clone your repository, make
+whatever changes you like to it and then push to your repository, in your
+account on NotABug.
-NotABug, libreboot's main git hosting provider, now provides a *pull requests*
-feature. <https://notabug.org/libreboot/> has the libreboot repository. Create an
-account on the website, then view the libreboot repo and click "fork" and clone
-your fork. Then commit your patch on top, and push into your repository (we
-recommend into a non-master branch). NotABug guides you through the process of
-pushing patches to it.
+Now, navigate to <https://notabug.org/libreboot/libreboot/pulls> and click
+*New Pull Request*.
-Once you have pushed your patches, go to the relevant repository on
-<https://notabug.org/libreboot/> and click "Pull Requests". Then click
-"New Pull Request". Select the relevant branches that you want to
-submit a pull request for, between the two repositories, and then click
-"Submit".
+You can submit your patches there. Alternative, you can log onto the Libreboot
+IRC channel and notify the channel of which patches you want reviewed, if you
+have your own Git repository with the patches.
Once you have issued a Pull Request, the Libreboot maintainers will be notified
via email. If you do not receive a fast enough response from the project, then
you could also notify the project via the #libreboot channel on FreeNode.
-
-Relevant links to bug trackers for discussing
-development (especially patch review) are on
-[NotABug](https://notabug.org/libreboot/libreboot/issues)
diff --git a/www/index.md b/www/index.md
index 6536ebbe..6daa8274 100644
--- a/www/index.md
+++ b/www/index.md
@@ -12,7 +12,7 @@ mascot"){#logo}](faq.md#who-did-the-logo)
[News](news/) --
[Contact/IRC](https://webchat.freenode.net/?channels=libreboot) --
[Report bugs](https://notabug.org/libreboot/libreboot/issues) --
-[Send patch](git.md)
+[Send patches](git.md)
Libreboot is a [free](https://en.wikipedia.org/wiki/Free_software) and Open
Source BIOS or UEFI replacement, initialising the hardware and booting your