(no commit message)
[libreriscv.git] / index.mdwn
index c9205b85efa0a6f3273f483e0f5df5919f605952..d304b08da82d45551013310b4b37cb9c6dc1fdd7 100644 (file)
@@ -1,53 +1,81 @@
-# 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 building 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]]
+# Our Team
+
+We are proud of our talented and diverse [team](current_members).
+
+# How Can I Help?
+
+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.
 
-----
+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/) and the [[charter]].
+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]]
@@ -64,6 +92,12 @@ TODO: add a list of upcoming project tasks/milestones (link to bugtracker).
 
 [1]: https://libre-riscv.org/3d_gpu/spike_sv/
 
-# Current Members
+# Wiki Structure
 
-[[current_members]]
+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]]