merging tutorials in the wiki

[cedlemo]

While I was reading the tutorials in your wiki, it appears that someone want to merge 3 of them: https://github.com/SciRuby/nmatrix/wiki/How-to-create-an-NMatrix https://github.com/SciRuby/nmatrix/wiki/Getting-started in https://github.com/SciRuby/nmatrix/wiki/Tentative-NMatrix-Tutorial

The tentative-NMatrix-Tutorial table of content is the following:

• Tentative NMatrix Tutorial
  • Introduction
  • Credit & Disclaimer
  • Prerequisites
  • Rules for editing
  • The basics
  • An example
  • NMatrix creation
  • Printing Arrays
  • Basic Operations
  • Universal Methods

--(the following parts are not done yet)--

• Indexing, Slicing and Iterating
  • Shape Manipulation
  • Changing the shape of an array
  • Stacking together different arrays
  • Splitting one array into several smaller ones
  • Copies and Views
  • No Copy at All
  • View or Shallow Copy
  • Deep Copy
  • Functions and Methods Overview
  • Less Basic
  • Broadcasting rules
  • Fancy indexing and index tricks
  • Indexing with Arrays of Indices
  • Indexing with Boolean Arrays
  • The ix_() function
  • Indexing with strings
  • Linear Algebra
  • Simple Array Operations
  • Tricks and Tips
  • “Automatic” Reshaping
  • Vector Stacking
  • Histograms
  • Further reading

Here is what I propose for the others wiki page (based on the existing page):

Getting-Started page:

• Installation -->remove
• Features (types of storage, API) -->remove
• Differences from other matrix libraries -->remove
• Brief Tutorial
  • Creating matrices --> merge in "NMatrix creation"
  • Simpler constructor for matrices --> merge in "NMatrix creation"
  • One-dimensional matrices -->merge in "NMatrix creation"
  • Matrix functions and operations --> merge in "Basic Operations"
  • Shortcuts --> merge in "NMatric creation" and "Indexing, Slicing ..."
  • Solving Linear systems -->remove
  • Matrix decomposition -->remove ?
  • Advanced features --> merge in "The basics" ?
  • additional data types
  • storage types

    How to create an NMatrix page:

• Introduction -->remove
• the type of a matrix's elements (dtype)--> merge in "The basics" ?
• the storage of a matrix--> merge in "The basics" ?
  • conclusion -->remove

I think that the "tentative-NMatrix-Tutorial" should be renamed to "Quickstart tutorial" like with numy. I think that the dtype and stype should be introduced in a separate wiki page which will be referenced in the "The Basics" part.

Please tell me if you are OK with this (or not).

[translunar]

@v0dro What are your thoughts?

[translunar]

@cedlemo Well, @v0dro hasn't replied. I'd say go for it. Thanks for offering!

[cedlemo]

I'd say go for it

Ok

[v0dro]

Sorry missed this. Yes sounds good.