In AutoIt beta 3.3.7.22 the documentation has undergone a visual style change. Please leave all feedback (positive and negative) in this thread so we can fine tune the style before release.
Documentation visual style feedback
Started by
Valik
, Dec 07 2011 06:40 PM
83 replies to this topic
#2
guinness
-
- MVPs
-
- 10,268 posts
guinness
Posted 07 December 2011 - 07:25 PM
As I've mentioned previously I'm liking the overall style of the Help file.
A couple of points to make:
1. What used to be grey text in the 'Example' section is being displayed as red text e.g. the WinAPI.au3 in #include <WinAPI.au3> is displaying as red text.
2. An extra line break between Parameters, Return Value, Remarks, Related & Example.
Thanks for the update.
A couple of points to make:
1. What used to be grey text in the 'Example' section is being displayed as red text e.g. the WinAPI.au3 in #include <WinAPI.au3> is displaying as red text.
2. An extra line break between Parameters, Return Value, Remarks, Related & Example.
Thanks for the update.
Edited by guinness, 07 December 2011 - 07:25 PM.
Example List: _AdapterConnections() • _AlwaysRun() • _AppMon() • _AppMonEx() • _BinaryBin() • _CheckMsgBox() • _CmdLineRaw() • _ContextMenu() • _DesktopDimensions() • _DisplayPassword() • _Fibonacci() • _FileCompare() • _FileCompareContents() • _FileNameByHandle() • _FilePrefix/SRE() • _FindInFile() • _GetBackgroundColor()/_SetBackgroundColor() • _GetConrolID() • _GetCtrlClass() • _GetDirectoryFormat() • _GetDriveMediaType() • _GetFilename()/_GetFilenameExt() • _GetHardwareID() • _GetIP() • _GetIP_Country() • _GetOSLanguage() • _GetSavedSource • _GetStringSize() • _GetSystemPaths() • _GetURLImage() • _GIFImage() • _GoogleWeather() • _GUICtrlCreateGroup() • _GUICtrlListBox_CreateArray() • _GUICtrlListView_CreateArray() • _GUICtrlListView_SaveCSV() • _GUICtrlListView_SaveHTML() • _GUICtrlListView_SaveTxt() • _GUICtrlListView_SaveXML() • _GUICtrlMenu_Recent() • _GUICtrlMenu_SetItemImage() • _GUICtrlTreeView_CreateArray() • _GUIDisable() • _GUIImageList_SetIconFromHandle() • _GUISetIcon() • _Icon_Clear()/_Icon_Set() • _InetGet() • _InetGetGUI() • _InetGetProgress() • _IPDetails() • _IsFileOlder() • _IsGUID() • _IsHex() • _IsPalindrome() • _IsRegKey() • _IsStringRegExp() • _IsUPX() • _IsValidType() • _IsWebColor() • _Language() • _Log() • _MicrosoftInternetConnectivity() • _MSDNDataType() • _PathFull/GetRelative/Split() • _PathSplitEx() • _PrintFromArray() • _ProgressSetMarquee() • _ReDim() • _RockPaperScissors()/_RockPaperScissorsLizardSpock() • _ScrollingCredits • _SelfDelete() • _SelfRename() • _SelfUpdate() • _SendTo() • _ShellAll() • _ShellFile() • _ShellFolder() • _SingletonHWID() • _SingletonPID() • _Startup() • _StringIsValid() • _StringReplaceWholeWord() • _StringStripChar() • _Temperature() • _TrialPeriod() • _UKToUSDate()/_USToUKDate() • _WinAPI_CreateGUID() • _WMIDateStringToDate()/_DateToWMIDateString() • AutoIt Search • AutoIt3 Portable • AutoItWinGetTitle()/AutoItWinSetTitle() • Coding • FileInstallr • GeoIP database • GUI - Only Close Button • GUI Examples • GUICtrlDeleteImage() • GUICtrlGetBkColor() • GUICtrlGetStyle() • GUIGetBkColor() • LockFile() • PasteBin • SciTE Jump • Signature Creator • WM_COPYDATA • More Examples...Updated: 11/04/2013
#3
Valik
-
- Active Members
-
- 18,879 posts
Former developer.
Posted 07 December 2011 - 07:38 PM
I don't know if trancexx changed the colors in examples or if that was a glitch in how I built it. I like the colors, though, because they are closer to my own.
As for extra line breaks, those are probably intentional. trancexx, you should probably explain the rationale behind this visual style. I think guinness may be the first of many who think extra whitespace is a mistake and not a design feature.
As for extra line breaks, those are probably intentional. trancexx, you should probably explain the rationale behind this visual style. I think guinness may be the first of many who think extra whitespace is a mistake and not a design feature.
#4
Melba23
-
- Moderators
-
- 15,306 posts
Yes, me!
Posted 07 December 2011 - 07:53 PM
I like the new style overall, but I have a couple of minor points:
- 1. The font in the "text" pages (e.g. Introduction, Command Line Parameters) is too large. In the example pages it is fine other than the initial explanation line above the syntax box which is of the same size as the "text" pages.
- 2. There are too many added blank lines in the example pages (as guinness mentioned above). It makes the whole page look too washed out and forces unnecessary scrolling.
trancexx,
Valik's comments seem to indicate that you were behind these changes. Please take the above as constructive criticism - I think the overall style is great improvement on what went before.
M23
- 1. The font in the "text" pages (e.g. Introduction, Command Line Parameters) is too large. In the example pages it is fine other than the initial explanation line above the syntax box which is of the same size as the "text" pages.
- 2. There are too many added blank lines in the example pages (as guinness mentioned above). It makes the whole page look too washed out and forces unnecessary scrolling.
trancexx,
Valik's comments seem to indicate that you were behind these changes. Please take the above as constructive criticism - I think the overall style is great improvement on what went before.
M23
StringSize - Automatically size controls to fit text - ExtMsgBox - A user customisable replacement for MsgBox
Toast - Small GUIs which pop out of the Systray - Marquee - Scrolling tickertape GUIs
Scrollbars - Automatically sized scrollbars with a single command - GUIFrame - Subdivide GUIs into many adjustable frames
GUIExtender - Extend and retract multiple sections within a GUI - NoFocusLines - Remove the dotted focus lines from buttons, sliders, radios and checkboxes
ChooseFileFolder - Single and multiple selections from specified path tree structure - - Notify - Small notifications on the edge of the display
RecFileListToArray - An alternative to _FileListToArray with user-defined include/exclude masks, maximum recursion level, sorting and displayed path options
GUIListViewEx - Insert, delete, move, drag and sort ListView items
#5
trancexx
-
- Active Members
-
- 5,186 posts
Hm, I really shouldn't.
Posted 07 December 2011 - 08:02 PM
Valik did that intentionally. You believe him?Valik's comments seem to indicate that you were behind these changes. Please take the above as constructive criticism - I think the overall style is great improvement on what went before.
M23
I saw new help file 30 minutes ago for the first time. I would have chosen thinner font for some stuff, for example.
eMyvnE
#6
Melba23
-
- Moderators
-
- 15,306 posts
Yes, me!
Posted 07 December 2011 - 08:04 PM
trancexx,
Well, perhaps.....
M23
Of course! Would our beloved leader ever tell intentional untruths?You believe him?
Well, perhaps.....
M23
StringSize - Automatically size controls to fit text - ExtMsgBox - A user customisable replacement for MsgBox
Toast - Small GUIs which pop out of the Systray - Marquee - Scrolling tickertape GUIs
Scrollbars - Automatically sized scrollbars with a single command - GUIFrame - Subdivide GUIs into many adjustable frames
GUIExtender - Extend and retract multiple sections within a GUI - NoFocusLines - Remove the dotted focus lines from buttons, sliders, radios and checkboxes
ChooseFileFolder - Single and multiple selections from specified path tree structure - - Notify - Small notifications on the edge of the display
RecFileListToArray - An alternative to _FileListToArray with user-defined include/exclude masks, maximum recursion level, sorting and displayed path options
GUIListViewEx - Insert, delete, move, drag and sort ListView items
#7
Valik
-
- Active Members
-
- 18,879 posts
Former developer.
Posted 07 December 2011 - 08:06 PM
Do not make me move the thread to a more visible forum. Also they can just look at the logs on the CSS and HTML files you changed to see who the author is.Valik did that intentionally. You believe him?
I saw new help file 30 minutes ago for the first time. I would have chosen thinner font for some stuff, for example.
#8
wraithdu
-
- MVPs
-
- 2,137 posts
I am less fun than a twisted ankle.
Posted 07 December 2011 - 08:14 PM
I like it, more MSDN flavor. I think the bigger font and extra space makes for easier reading. Maybe that's my oldish eyes talking...
#9
Homes32
-
- Active Members
-
- 51 posts
Wayfarer
Posted 07 December 2011 - 09:04 PM
the orange text looks nice but I think the old black was easier to read on the white background.
#10
SkinnyWhiteGuy
-
- Active Members
-
- 421 posts
Feed the bunny!
Posted 07 December 2011 - 09:20 PM
I like the new looks of it. The extra white space is a little much, but I can see how it can work. Looking at the source for the 3.3.6.1 help files, those extra line breaks were there already. It looks like they were needed with the old style, but not as much now.
#11
Bowmore
-
- Active Members
-
- 780 posts
Feinschmecker
Posted 07 December 2011 - 09:30 PM
The new documentation style gets the thumbs up from me. I find it much easier to read and generally looks cleaner. The extra whitespace and coloured headings makes the different sections stand out.
"Programming today is a race between software engineers striving to build bigger and better idiot-proof programs, and the universe trying to build bigger and better idiots. So far, the universe is winning."- Rick Cook
#12
BrewManNH
-
- MVPs
-
- 6,803 posts
באָבקעס מיט קודוצ׳ה
Posted 07 December 2011 - 09:59 PM
I'm of the exact opposite opinion, while I like the colors and such.
The excess whitespace makes for bad readability, for me. The font for the code examples are too small compared to the rest of the page information, it looks like it was thrown in as an after thought and shrunk to fit. The header text is FAR too large in comparison to the rest of the text on the page and isn't needed to be that large for a help file entry.
The excess whitespace makes for bad readability, for me. The font for the code examples are too small compared to the rest of the page information, it looks like it was thrown in as an after thought and shrunk to fit. The header text is FAR too large in comparison to the rest of the text on the page and isn't needed to be that large for a help file entry.
How to ask questions the smart way!
Back up and restore Windows user files _Array.au3 - Modified array functions that include support for 2D arrays.ColorChooser - An add-on for SciTE that pops up a color dialog so you can select and paste a color code into a script.
Customizable Splashscreen GUI w/Progress Bar - Create a custom "splash screen" GUI with a progress bar and custom label.
_FileGetProperty - Retrieve the properties of a file SciTE Toolbar - A toolbar demo for use with the SciTE editorGUIRegisterMsg demo - Demo script to show how to use the Windows messages to interact with controls and your GUI.
GUIToolTip UDF Demo - Demo script to show how to use the GUIToolTip UDF to create and use customized tooltips.
#13
D4RKON3
-
- Active Members
-
- 372 posts
Universalist
Posted 07 December 2011 - 10:20 PM
Vote for new style in documentation, i really like it.
It's now much cleaner and readable, i have no problem with reading it. It looks like the MSDN and it makes me to feel better.
It's now much cleaner and readable, i have no problem with reading it. It looks like the MSDN and it makes me to feel better.
Edited by D4RKON3, 07 December 2011 - 10:20 PM.
- Manadar likes this
#15
ChrisN
-
- Active Members
-
- 72 posts
Wayfarer
Posted 07 December 2011 - 10:58 PM
I personally don't really care for the large fonts, & the headings are too large even with the larger body text. Also, there are some inconsistent font sizes in some articles, e.g. String Regular expression Tutorial
#16
Zedna
-
- MVPs
-
- 8,315 posts
AutoIt rulez!
Posted 08 December 2011 - 12:02 AM
The excess whitespace makes for bad readability, for me. The font for the code examples are too small compared to the rest of the page information, it looks like it was thrown in as an after thought and shrunk to fit. The header text is FAR too large in comparison to the rest of the text on the page and isn't needed to be that large for a help file entry.
The same for me.
I think:
- section header without blue background as in previous version is worse
- header text (function name) is too big
- orange color of section names is bad - should be more dark and more bold, maybe some better color
- too much spaces (empty rows) between sections - it looks really worse than in previous version
- font for example scripts is too small - should be the same as in previous version
- all (not auto generated?) pages beside Functions/UDFs are with bad font (bold/too big)
I don't like new style. Previous one was much better.
EDIT:
It didn't work when helpfile was opened by installer during update. At that moment also index Tab of helpfile was empty. After reopening helpfile (close+open) all works fine.
Edited by Zedna, 08 December 2011 - 12:14 AM.
#17
Bowmore
-
- Active Members
-
- 780 posts
Feinschmecker
Posted 08 December 2011 - 12:18 AM
It looks like we have a Marmite situation developing.
"Programming today is a race between software engineers striving to build bigger and better idiot-proof programs, and the universe trying to build bigger and better idiots. So far, the universe is winning."- Rick Cook
#18
MvL
-
- Active Members
- 39 posts
Seeker
Posted 08 December 2011 - 12:30 AM
Hi,
perhaps it is because of the small font, but the font in the example code seems to be Italic,
and that makes it less readable.
The general colourscheme is an improvement though.
perhaps it is because of the small font, but the font in the example code seems to be Italic,
and that makes it less readable.
The general colourscheme is an improvement though.
#19
Valik
-
- Active Members
-
- 18,879 posts
Former developer.
Posted 08 December 2011 - 12:43 AM
If you guys see pages that do not match the new theme then please list them. Unfortunately the documentation isn't as... elegant as it could be with regards to web technology (Lots of styles are hard-coded). We need some help spotting all these pages so if you see one please tell us where it is.
#20
jaberwocky6669
-
- Active Members
-
- 2,076 posts
Dull light.
Posted 08 December 2011 - 03:46 AM
Other than the aforementioned whitespace issue, I like the new look. It looks -- friendly.
RegisterDeviceNotifications | FunctionNameLister | SciTE Customization GUI | MouseHover --> CallTips
0 user(s) are reading this topic
0 members, 0 guests, 0 anonymous users
