(no commit message)
[libreriscv.git] / index.mdwn
index 63a28c9481564a45f82be37909550a6faee539d8..d972b49206b5f90d2e1185acd8562b93b89be5b8 100644 (file)
@@ -1,53 +1,77 @@
-# 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 safe chip. A trusted chip.
 
-This is a publicly editable wiki.
+> A chip with lots of peripherals. And a gpu. And an AI accelerator...
 
-All wikis are supposed to have a [[SandBox]], so this one does too.
+> Oh and here, have the source code...
 
-This wiki is powered by [[ikiwiki]].
+Sounds cool? Learn more [here](who_we_are)
 
-This is the sitemap: [[sitemap]]
+# Join us in Realizing the First Market Ready LibreSOC!
+
+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]].
 
-----
+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.
 
-# Joining/Onboarding Process
+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``
 
-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/).
+4. If you plan to do HDL work, you should familiarize yourself with our [[HDL_workflow]].
 
-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.
+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.
 
-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.
+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.
+
+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)
 
-Long-term we mainly need HDL engineers at the moment. 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. 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
+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 +87,17 @@ TODO: add a list of upcoming project tasks/milestones
 * [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]]