Skip to content

merging tutorials in the wiki #527

Open
@cedlemo

Description

@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).

Activity

translunar

translunar commented on Jul 18, 2016

@translunar
Member

@v0dro What are your thoughts?

translunar

translunar commented on Jul 25, 2016

@translunar
Member

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

cedlemo

cedlemo commented on Jul 25, 2016

@cedlemo
Author

I'd say go for it

Ok

v0dro

v0dro commented on Jul 25, 2016

@v0dro
Member

Sorry missed this. Yes sounds good.

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @translunar@cedlemo@v0dro

        Issue actions

          merging tutorials in the wiki · Issue #527 · SciRuby/nmatrix