Author Topic: 1.6.9 is installed...where are the help files?  (Read 10428 times)

Offline sreilly

  • PixInsight Padawan
  • ****
  • Posts: 791
    • Imaging at Dogwood Ridge Observatory
1.6.9 is installed...where are the help files?
« on: 2010 December 23 15:02:58 »
Maybe I'm more confused than I usually am but after installing 1.6.9 I was expecting to find help files under Help on the top menu but that isn't there so I would try Resources next. Isn't there either. What am I missing? This should be similar to other help systems in other software isn't it? Indexed and searchable?

Steve
Steve
www.astral-imaging.com
AP1200
OGS 12.5" RC
Tak FSQ-106ED
ST10XME/CFW8/AO8
STL-11000M/FW8/AO-L
Pyxis 3" Rotator
Baader LRGBHa Filters
PixInsight/MaxIm/ACP/Registar/Mira AP/PS CS5

Offline Enzo De Bernardini

  • PTeam Member
  • PixInsight Addict
  • ***
  • Posts: 274
  • Resistance is futile.
    • Astronomí­a Sur
Re: 1.6.9 is installed...where are the help files?
« Reply #1 on: 2010 December 23 15:29:34 »
Hi Steve,

Check inside the Process Explorer panel (see attach). You need to expand this panel with the double-blue-arrows at bottom.

Regards,

Enzo.

Offline sreilly

  • PixInsight Padawan
  • ****
  • Posts: 791
    • Imaging at Dogwood Ridge Observatory
Re: 1.6.9 is installed...where are the help files?
« Reply #2 on: 2010 December 23 15:46:31 »
Well that's different but as far as I can see the only search capability is within the active document. I don't think I've ever seen help accessed in this manner.

Thanks,
Steve
www.astral-imaging.com
AP1200
OGS 12.5" RC
Tak FSQ-106ED
ST10XME/CFW8/AO8
STL-11000M/FW8/AO-L
Pyxis 3" Rotator
Baader LRGBHa Filters
PixInsight/MaxIm/ACP/Registar/Mira AP/PS CS5

Offline Nocturnal

  • PixInsight Jedi Council Member
  • *******
  • Posts: 2727
    • http://www.carpephoton.com
Re: 1.6.9 is installed...where are the help files?
« Reply #3 on: 2010 December 23 15:51:10 »
Well Juan likes to reinvent the wheel. Sometimes that works out well, other times not so much. I'm happy there are help files now but the implementation isn't great IMO. New users won't be able to find it. Let's hope Juan is open to suggestions after the fact and makes some changes for the next version.
Best,

    Sander
---
Edge HD 1100
QHY-8 for imaging, IMG0H mono for guiding, video cameras for occulations
ASI224, QHY5L-IIc
HyperStar3
WO-M110ED+FR-III/TRF-2008
Takahashi EM-400
PIxInsight, DeepSkyStacker, PHD, Nebulosity

Offline zvrastil

  • PixInsight Addict
  • ***
  • Posts: 179
    • Astrophotography
Re: 1.6.9 is installed...where are the help files?
« Reply #4 on: 2010 December 24 01:33:57 »
Yeah, it would be great to access the help for example by pressing '?' button on the titlebar of the process interface. Or by pressing F1. It is really shame to hide such great documentation so only people who know PixInsight inside-out can find it  >:D.

Zbynek

Offline Juan Conejero

  • PTeam Member
  • PixInsight Jedi Grand Master
  • ********
  • Posts: 7111
    • http://pixinsight.com/
Re: 1.6.9 is installed...where are the help files?
« Reply #5 on: 2010 December 24 02:34:36 »
I don't think I am reinventing the wheel here; I am just trying to provide the beast with better wheels. Everything you ask for is already planned, and perhaps more :)

The current documentation integration with Process Explorer is just the first stage of the integrated documentation functionality of PixInsight. The next stages are:

- The PixInsight Assistant application (note: the actual name might change in the final implementation). This is just a custom adaptation of the Qt Assistant application. The assitant wil run as an independent application. You'll be able to launch it from the Resources menu, and also from the Start > PixInsight Platform on Windows.

- A Browse Documentation button on the control bars of all process interface windows (to the left of the Reset button). By the way, this is just one of a series of new control bar buttons that will extend the standard functionality of process interfaces. The Browse Documentation button will open a floating window with a WebKit browser (similar to the current integration in Process Explorer) loaded with the documentation for the tool in question (if it exists).

Quote
I'm happy there are help files now but the implementation isn't great IMO. New users won't be able to find it.

The current integration with Process Explorer still needs some work, but I definitely like the concept. For example, as has been noted in other posts, I have to improve the way documents are automatically resized to the explorer when it is resized, floated, etc. Documents are also being printed poorly due to deficiencies in the CSS sheets associated with pidoc documents (this is unrelated to the integration with Process Explorer, actually).

IMO, the difficulties for new users are unrelated to the integration of the documentation with Process Explorer. The problem here is that new users tend to look for processes under the main menu; they seem to be reluctant to use Process Explorer. This requires just good video tutorials showing all the features of PI's user interface and how to use them.
Juan Conejero
PixInsight Development Team
http://pixinsight.com/

Offline mmirot

  • PixInsight Padawan
  • ****
  • Posts: 881
Re: 1.6.9 is installed...where are the help files?
« Reply #6 on: 2010 December 24 06:46:26 »
It is fine as is but we need more content as soon as you can.

Max

Offline Harry page

  • PTeam Member
  • PixInsight Jedi Knight
  • *****
  • Posts: 1458
    • http://www.harrysastroshed.com
Re: 1.6.9 is installed...where are the help files?
« Reply #7 on: 2010 December 24 07:16:30 »
The problem here is that new users tend to look for processes under the main menu; they seem to be reluctant to use Process Explorer. This requires just good video tutorials showing all the features of PI's user interface and how to use them.
[/font][/color]



Nooooooooooooooooooooooooooo    Harry  >:D
Harry Page

Offline Nocturnal

  • PixInsight Jedi Council Member
  • *******
  • Posts: 2727
    • http://www.carpephoton.com
Re: 1.6.9 is installed...where are the help files?
« Reply #8 on: 2010 December 24 12:39:05 »
Quote
The problem here is that new users tend to look for processes under the main menu; they seem to be reluctant to use Process Explorer. This requires just good video tutorials showing all the features of PI's user interface and how to use them.

Don't try to solve this 'problem' with more videos. Past videos have not truly helped to make PI more accessible. Past videos have not reduced the call for proper documentation. Past videos have not compensated for non-standard GUI design.

All that's required is a 'help' menu item just like -every other- well designed application has. Under that help menu you could either list all available help items or even better, a master help browser with search facility. In addition the help files should be accessible from the process when it's loaded. A long time ago I suggested you add a 'help' icon (say a '?') to every process window standard dressings. I still think that's much better than hiding it in the process explorer. Please add that or something similar.

Please don't make help too complicated and different from what we see around us. You gain nothing if new users need yet another video or tutorial to access help. I mean it's absurd, frankly. Sorry for the harsh words but they're needed here.
Best,

    Sander
---
Edge HD 1100
QHY-8 for imaging, IMG0H mono for guiding, video cameras for occulations
ASI224, QHY5L-IIc
HyperStar3
WO-M110ED+FR-III/TRF-2008
Takahashi EM-400
PIxInsight, DeepSkyStacker, PHD, Nebulosity

Offline jtheios

  • Newcomer
  • Posts: 20
Re: 1.6.9 is installed...where are the help files?
« Reply #9 on: 2010 December 24 13:14:41 »
I have to jump in here in defense of the video tutorials. Since this is my first post, I have to say how impressed I am with the entire software platform, the team that created it, and the community that supports it. It has most definitely improved the quality of my processed images. I have only been using it for several months, but I'm just so excited every time I use it. I am in the software business myself, and I can appreciate the effort that goes into something like this and the commitment it takes from those involved, especially from a small development team. Thanks so much.

I think like a lot of folks I struggled to use and understand the LE version of the software. Every so often I'd dig it out and try again to figure out how to use it. I was reluctant to download the 45-day trial license because I was concerned that I'd not "get it" before time ran out. Only when I found Harry's wonderful video tutorials, did I feel confident enough to jump in.

IMO the processing techniques (and options to use them) are different enough from Photoshop that video tutorial have a real place in helping new users with the concepts the platform offers. I do love the new documentation (and don't have a problem at all with the way Juan has implemented it), but for new users, I think seeing the software in action is more useful in the beginning in getting them up to speed.

Several months into my new adventure I can say that I'd never go back to Photoshop!

- John

Offline Harry page

  • PTeam Member
  • PixInsight Jedi Knight
  • *****
  • Posts: 1458
    • http://www.harrysastroshed.com
Re: 1.6.9 is installed...where are the help files?
« Reply #10 on: 2010 December 24 13:22:15 »
Every so often I'd dig it out and try again to figure out how to use it. I was reluctant to download the 45-day trial license because I was concerned that I'd not "get it" before time ran out. Only when I found Harry's wonderful video tutorials, did I feel confident enough to jump in.
Several months into my new adventure I can say that I'd never go back to Photoshop!- John


YYYYYYYYeeeeeeeeeeeessssssssssssssssssssssssss  :D


Harry
Harry Page

Offline Nocturnal

  • PixInsight Jedi Council Member
  • *******
  • Posts: 2727
    • http://www.carpephoton.com
Re: 1.6.9 is installed...where are the help files?
« Reply #11 on: 2010 December 24 14:17:53 »
Not sure why anyone felt they had to 'jump in' to defend the videos. They are terrific and without them PI would probably not have half the users. It's just that I strongly disagree with Juan's statement that a video tutorial should be added to show people how to access help. That's backwards. Help should be accessible by anyone, new or experienced, without having to first watch a video.
Best,

    Sander
---
Edge HD 1100
QHY-8 for imaging, IMG0H mono for guiding, video cameras for occulations
ASI224, QHY5L-IIc
HyperStar3
WO-M110ED+FR-III/TRF-2008
Takahashi EM-400
PIxInsight, DeepSkyStacker, PHD, Nebulosity

Offline Harry page

  • PTeam Member
  • PixInsight Jedi Knight
  • *****
  • Posts: 1458
    • http://www.harrysastroshed.com
Re: 1.6.9 is installed...where are the help files?
« Reply #12 on: 2010 December 24 14:22:46 »
Not sure why anyone felt they had to 'jump in' to defend the videos. They are terrific and without them PI would probably not have half the users. It's just that I strongly disagree with Juan's statement that a video tutorial should be added to show people how to access help. That's backwards. Help should be accessible by anyone, new or experienced, without having to first watch a video.

Yep got to agree with sander on this  >:D

Harry
Harry Page

Offline Andres.Pozo

  • PTeam Member
  • PixInsight Padawan
  • ****
  • Posts: 927
Re: 1.6.9 is installed...where are the help files?
« Reply #13 on: 2010 December 26 11:36:09 »
IMO, the difficulties for new users are unrelated to the integration of the documentation with Process Explorer. The problem here is that new users tend to look for processes under the main menu; they seem to be reluctant to use Process Explorer. This requires just good video tutorials showing all the features of PI's user interface and how to use them.
Juan, I have been using PixInsight for the past two years and I still don't use the Process Explorer. I use the menu and I would like to use keyboard shortcuts but I don't know if there is any. I don't know what is the necessity for the Process Explorer and why I should use it. It is not faster than using the menu and I am used to look for the commands in other places (toolbars, menus or keyboard shortcuts).

Offline Harry page

  • PTeam Member
  • PixInsight Jedi Knight
  • *****
  • Posts: 1458
    • http://www.harrysastroshed.com
Re: 1.6.9 is installed...where are the help files?
« Reply #14 on: 2010 December 26 14:06:48 »
Hi

I guess its up to you what you use  ;)  but here are some keyboard shortcuts http://www.harrysastroshed.com/pixuser/shortcut.html


Regards Harry
Harry Page