The page is already arranged as you suggest:
Overview explaining the 3 components, indicating which are optional
Instructions for installing base
Instructions for installing Qt
Instructions for installing addons
I believe this conforms to the principles you give: it clearly shows
what's optional & contains pointers to the install pages for Qt IDE and
addons. It also functions as a Quick Start guide for user using the AOI
installers.
[BTW, before I started working on this I could not find anywhere in the
new-user docs that suggests that they load the addons as a part of
getting J running. I wanted to make sure they see that as an optional
portion of installation]
I will await further instructions about how to repackage the pages.
The kids' problem is not the Windows AIO installer, which they manage
successfully. It's with the Mac, which they find baffling. And it
baffles me too! So I need an expert to write an explanation.
Henry
On 8/3/2015 9:53 AM, chris burke wrote:
We originally had separate installation instructions for the base system
and the installation of the Qt IDE.
I think it is best this way. There is far too much information to be on a
single page, and this complicates things. It is already a large page, and
even now not all the information has been copied over from the Qt install
page.
Moreover, the end user should understand that the base system and IDE are
different things. After all, many users don't even install the Qt IDE, but
use JHS or the console. This understanding also helps when updating the
system.
So I suggest that we have separate instructions for the base system,
instructions for the Qt IDE, and instructions for addons. There is no harm
in pointing to the Windows AIO installers in the instructions for the base
system as doing the first two of these.
What would solve Henry's problem with schoolchildren is a quick start guide
for Windows that describes how to install a full Jqt system with all addons
starting with an AIO installer. This could point to the detailed
instruction pages for anyone wanted to customize the system in some way.
On 3 August 2015 at 06:17, Henry Rich <[email protected]> wrote:
Thanks, guys, I have a new version up that addresses the issues raised by
Bill and Brian (except that I still call for use of Package Manager because
I think having them start Jconsole is more confusing).
I still need expert help in 2 areas:
1. Under (optional) Install the Qt IDE there is a reference to the name
of the program under Windows but not under other OSs. What should that
name be?
2. The instructions for installing on the Mac are not easy enough to use.
Some of my students are 14-year-old girls with no computer experience and
they have to get J installed. Can somebody write a sequence of steps that
they can understand?
Henry
On 8/2/2015 8:51 PM, Brian Schott wrote:
I note that most references in the current jwiki page are to Qt IDE, but
occasionally the term jqt is used, as a synonym, without a formal
connection being made. I think that should be fixed.
I also note that the reference link to Package manager is at the anchor
#install which is a little jarring to see pop up. As a matter of fact for
a
beginner I think the task of requiring the use of Package manager is very
off-putting, and that leads to my next question, below.
Under the Mac installation mention is made of "install 'all'" from
jconsole. What does this do and would it be a good alternative for
beginners of ALL platforms who want to experiment without having to read
all of these instructions carefully?
For example is the JFE JHS always installed on all platforms, and if so
why
is it not mentioned in the "What is installed" section?
Bill has added some other comments that must be answered before this jwiki
page is taken out of Beta, imo.
Clearly, I am a little confused about Henry's request that I write a
section. But I offer the text below as a partial draft.
*************
What is not installed
The next session covers the installation of "packages" which is the main
omission in the installation on all platforms. "Packages" are often
called
"Libraries" elsewhere.
As noted above, on some platforms, notably Windows, the Qt IDE is
automatically installed, but in other cases another step is required for
that installation, but both jconsole and JHS are installed automatically.
If the Qt IDE has not been automatically installed, then it can be
installed via the jconsole JFE as described in the link provided.
On Sun, Aug 2, 2015 at 7:56 PM, Henry Rich <[email protected]> wrote:
http://www.jsoftware.com/jwiki/System/Installation/J804
I have tried to respond to the suggestions given here by adding text
explaining things and adding a section focused on new users. There are
errors and omissions that need to be fixed by someone who knows the
answers:
1. Android is not listed under the supported platforms
2. There is a note in the installation page saying that jconsole is
renamed to ijconsole; this conflicts with the info under 'What Is
Installed' and later references to jconsole.
3. Someone who knows how to install on:
Mac
Linux
Android
Raspberry Pi
needs to go into the 'If You Are New to J' section and list the steps for
those platforms. There is a lot of information under 'OS-specific
Information' but you'd have to be a geek to make sense of it. We need
some
simple instructions for ordinary users, especially Mac users.
Henry Rich
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm
