Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

merging tutorials in the wiki #527

Open
cedlemo opened this issue Jul 9, 2016 · 4 comments
Open

merging tutorials in the wiki #527

cedlemo opened this issue Jul 9, 2016 · 4 comments

Comments

@cedlemo
Copy link

cedlemo commented Jul 9, 2016

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
Copy link
Member

@v0dro What are your thoughts?

@translunar
Copy link
Member

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

@cedlemo
Copy link
Author

cedlemo commented Jul 25, 2016

I'd say go for it

Ok

@v0dro
Copy link
Member

v0dro commented Jul 25, 2016

Sorry missed this. Yes sounds good.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants