Great article. I didn't read it all, but I did have one suggestion. You
cover aliases and abbreviations, then say that abbreviations are preferred.
If they are preferred, put them first; for the new learner, you should
always put the thing you want them to learn first, first. When struggling
with a new language it's no fun to learn one thing, then learn that there
is a better way to do it *after* you've struggled to learn the first.
Roughly equivalent to teaching someone 'thee' and 'thou' before explaining
that those are archaic and we generally use just 'you' now.
On Thu, Oct 5, 2017 at 8:40 PM Mark Volkmann <r.mark.volkm...@gmail.com>
wrote:
> Hello all! I've been working very hard on a long article that I hope can
> bring more attention to fish. I just started learning about fish about
> three months ago and have been documenting everything I've learned. I
> absolutely love it!
>
> It would be great if you could review this and give me feedback on any
> errors in the article or things that could be explained better. In some
> ways it is more of a reference guide and is quite long (34 pages), but it's
> no replacement for the excellent documentation that the main fish website
> already provides.
>
> You can find the article at https://mvolkmann.github.io/fish-article/.
>
> I am not advertising this elsewhere yet and want to keep it under wraps
> until I'm ready to announce the final version on 11/1. Of course I'd be
> glad to make updates after that date, but want it to be as good as possible
> by that date.
>
> Feel free to send me any feedback, no matter how minor.
>
> --
> R. Mark Volkmann
> Object Computing, Inc.
>
> ------------------------------------------------------------------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> _______________________________________________
> Fish-users mailing list
> Fish-users@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/fish-users
>
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Fish-users mailing list
Fish-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/fish-users
