(no commit message)
[libreriscv.git] / index.mdwn
index 5c846aec854b9fc06a03f53e90754a53ed59cdcd..72f72aac75639b49bf124a0831fc2a673240af84 100644 (file)
@@ -1,53 +1,73 @@
-# Welcome to Libre-SoC!
+# Welcome to LibreSoC
 
-Libre-RISCV is an effort to develop an completely open/Libre SOC that is open to the bedrock!
+> We're gonna build a chip. A fast chip. A chip with lots of peripherals. And a gpu. Here have the source code.
 
-This is a publicly editable wiki.
+Sounds cool? Learn more [here](who_we_are)
 
-All wikis are supposed to have a [[SandBox]], so this one does too.
+# Join us in Realizing the First Market Ready LibreSOC!
 
-This wiki is powered by [[ikiwiki]].
+1. First, join the
+[mailing list](http://lists.libre-riscv.org/mailman/listinfo/libre-riscv-dev),
+introduce yourself, and read through
+[recent posts](http://lists.libre-riscv.org/pipermail/libre-riscv-dev/)
+and the [[charter]].
 
-This is the sitemap: [[sitemap]]
+2. The next thing you should do is read through the [bugs
+list](http://bugs.libre-riscv.org) and see if there are any bugs that
+pique your interest.
 
-----
+3. After that, go ahead and take a look at the resources section below. 
+Try and clone a repository with ``git clone https://git.libre-riscv.org/git/repositoryname.git``
 
-# Joining/Onboarding Process
+4. If you plan to do HDL work, you should familiarize yourself with our [[HDL_workflow]].
 
-This process probably needs some improvement, but the basic 
-idea is to join the [mailing list](http://lists.libre-riscv.org/mailman/listinfo/libre-riscv-dev), introduce yourself,
-and read through [recent posts](http://lists.libre-riscv.org/pipermail/libre-riscv-dev/).
+5. We do have funding available (see [[nlnet]]) upon completion of issues -
+we are also working on procuring more funding which gets the project to
+nanometre scale tapeout.
 
-The next thing you should do is read through the [bugs list](http://bugs.libre-riscv.org) and see if there are any bugs that pique your interest.
+6. After all this, if you feel that Libre-SoC is a good cause that
+you would like to contribute to, add yourself to the [[current_members]]
+page, fill in some information about yourself, and join the mailing list
+and say hello.
 
-We do have funding available (see [[nlnet]]) upon completion of issues - we are also working on procuring more funding which gets the project to nanometre scale tapeout.
+Also note that you can edit this wiki. See the last section of this page.
 
 ## Needed Skills
 
-Most labor is currently being applied to developing the GPU portion of the LibreSOC.
+Most labor is currently being applied to developing the GPU portion of
+the Libre-SoC.
 
-The highest priority needed at the moment is a c++ engineer to work on a MESA 3D driver. This will begin life as similar to SwiftShader however retaining the vectorisation and predication intrinsics.
+The highest priority needed at the moment is a c++ engineer to work on
+a MESA 3D driver. This will begin life similar to SwiftShader however
+retaining the vectorisation and predication intrinsics as well as hardware accelerated opcodes (all of which SwiftShader lacks)
 
-Medium to long-term we need HDL engineers. Particularly those familiar with nMigen or just python.  Most of the techniques being used require software engineering skills (OO design, polymorphism) than they do more traditional HDL programming skills. Basically if you have experience in 2 of the following you'll do fine: python, nmigen, verilog/VHDL/gate-level design. See [[HDL_workflow]]
+Medium to long-term we need HDL engineers. Particularly those familiar
+with nMigen or just python.  Most of the techniques being used require
+software engineering skills (OO design, polymorphism) than they do more
+traditional HDL programming skills. Basically if you have experience in 2
+of the following you'll do fine: python, nmigen, verilog/VHDL/gate-level
+design. See [[HDL_workflow]]
 
-Also, individuals with experience in formal mathematical verification are quite welcome.
+Also, individuals with experience in formal mathematical verification
+are quite welcome.
 
-TODO: add a list of upcoming project tasks/milestones (link to bugtracker).
+TODO: add a list of upcoming project tasks/milestones (link to
+bugtracker).
 
 # Resources
 
-* Mailing Lists <http://lists.libre-riscv.org> -
-  Archives at <http://lists.libre-riscv.org/pipermail>
-* Git repositories <http://git.libre-riscv.org>
-  may be cloned publicly with
-  git clone https://git.libre-riscv.org/git/repositoryname.git
-* Bugzilla at <http://bugs.libre-riscv.org/>
-* Kazan (Vulkan driver) at <https://salsa.debian.org/Kazan-team/kazan>
-* Further Information [[resources]]
+| Resource | Link |
+| --- | --- |
+| Bugs and Tasks | <http://bugs.libre-riscv.org/> |
+| Mailing Lists | <http://lists.libre-riscv.org> |
+| Archives | <http://lists.libre-riscv.org/pipermail> |
+| Git repositories | <http://git.libre-riscv.org> |
+| Kazan (Vulkan driver) | <https://salsa.debian.org/Kazan-team/kazan> |
+| Further Information | [[resources]] |
 
 # Main Pages
 
-* Libre-RISCV [[charter]]
+* Libre-SoC [[charter]]
 * [[shakti/m_class]]
 * [[alt_rvp]]
 * [[3d_gpu]]
@@ -63,3 +83,17 @@ TODO: add a list of upcoming project tasks/milestones (link to bugtracker).
 * [Set-Up Instructions][1]
 
 [1]: https://libre-riscv.org/3d_gpu/spike_sv/
+
+# Current Members
+
+[[current_members]]
+
+# Wiki Structure
+
+This is a publicly editable wiki.
+
+All wikis are supposed to have a [[SandBox]], so this one does too.
+
+This wiki is powered by [[ikiwiki]].
+
+This is the sitemap: [[sitemap]]