Re: Proposal for new Octave website

[edmund ronald]

If there were a way to make this publicly editable, we wouldn't really be having the Forge discussion, somebody would just go and do it. That is the big strength of the wiki model - if something takes off it gets to be immortal like a coral reef. Can some way be found to combine the strengths of this proposal and the quick-edit/rollback functionality of wiki? If it is Git tech, maybe we can hand out commit privileges, have random contributors issue pull requests, and there is merge and rollback built in? 

Edmund

On Mon, Nov 9, 2015 at 11:48 AM, Doug Stewart <address@hidden> wrote:

On Mon, Nov 9, 2015 at 3:15 AM, Alex Krolick <address@hidden> wrote:

> On the other hand, if one cannot edit directly links will go stale, mistakes go unfixed. The wiki has the advantage that one can just update at will. I wonder if some solution can be found so it becomes easy to edit these new pages.

I made the site with Jekyll, which is a static site generator. The main pages are all Markdown---pretty easy to edit. The index is plain HTML but not too bad to work with, in my opinion. Considering the current site is also static, this should probably be a separate discussion point once the content is hammered out.

> What about a buttons that says "Packages" or "Extend Octave"

The Forge section could be bumped up into the installation section and a link could be added to the top bar, but I am not sure if that information is useful to newcomers. New users won't know what packages they need until they are familiar with the core library. There should probably be a Getting Started guide that covers the basic architecture of the project, syntax, usage of the basic modules, etc. at a level between the syntax examples and the docs.

I agree with this last statement.  ( and all these ideas)

Doug

 

-Alex

On Sun, Nov 8, 2015 at 11:50 PM, Juan Pablo Carbajal <address@hidden> wrote:

On Mon, Nov 9, 2015 at 1:02 AM, Doug Stewart <address@hidden> wrote:

On Sun, Nov 8, 2015 at 6:51 PM, Alex Krolick <address@hidden> wrote:

Hi all,

I just added sections for octave-forge here:
http://whokilledtheelectricmonk.github.io/octave-web/#develop
http://whokilledtheelectricmonk.github.io/octave-web/contribute/#octave-forge

-Alex

Thanks.

I would suggest to add after this:

"

Installing packages

You can find the list of packages here. To install a package, use the pkg command from the Octave prompt by typing:

pkg install -forge package_name 

where package_name is the name of the package you want to install.

"

To now  use the package it must be "loaded".

pkg load package_name

I have had to explain this to beginners, so it would be nice to have this much info right at the start.

Doug

 

 

On Sun, Nov 8, 2015 at 2:49 PM, Doug Stewart <address@hidden> wrote:

On Sun, Nov 8, 2015 at 5:02 PM, Jordi Gutiérrez Hermoso <address@hidden> wrote:

Hello,

While asking for contributions for a new website, Alex Krolick has
contributed the following proposal:

    http://whokilledtheelectricmonk.github.io/octave-web/install/

Source code:

    https://github.com/whokilledtheelectricmonk/octave-web

I think it looks really good. Alex seems interested in contributing
this as our new website. What does everyone else think?

- Jordi G. H.

I took a quick look and did not see anything about Octave forge!!!!

I think it is very important to introduce forge and the idea of added packages, at this top level.

Doug

--

DAS

--

DAS

Cold it bepossible to have a more principal participantion of Forge?

At the moment it looks like something only developers or savy uers should know about.

What about a buttons that says "Packages" or "Extend Octave".

I do not feel strongly about it, but it will help bringing forge and octave together in the mind of the user.

--

DAS