Add a common use "functions" section

[joedf]

Add a common use "functions" section

[G33kDude]

I have a few of my own one-off functions that would fit there. Things like FixIE, that don't really call for a whole library.

[joedf]

Hmm sounds perfect

[vasili111]

@joedf , @G33kDude, @evilC

Good idea!
What you think, where exactly it should be? Before "Libraries" and "Libraries distributions" or after them?

Also what you think, maybe it is better to put "Library distributions" before "Libraries" or it is better to leave as it is?

[joedf]

I'm thinking, libraries before lib distros. Sort of a hierarchy order.

[vasili111]

@joedf
So:

• Libraries
• Library Distributions
• Functions
• Scripts
• Tools
• Tutorials
• Resources

Right?

[G33kDude]

I was thinking that functions should be a subset of libraries (or perhaps vice versa)

[joedf]

Functions first, I'd say... ?

[hi5]

Isn't the problem there are literally hundreds of useful functions? That is the problem I face with https://github.com/hi5/pAHKlight as well - could add entries on a daily basis ...

[joedf]

Hmm you're right, but I thinking those functions that are only do one thing specially, I'm sure we could find some nice examples

[G33kDude]

Is there a way to make collapsible sub-sections in markdown?

[joedf]

Eurhh... Not really, unless it's a custom flavoured md :p

[vasili111]

Functions first, I'd say... ?
@joedf sure :)

I was thinking that functions should be a subset of libraries (or perhaps vice versa)

@G33kDude You mean like this?

• Libraries
  • Clipboard
  • Console
  • Database
  • Functions
  • Filesystem
  • Graphics
  • GUI
  • Hotkeys

I dont think it is a good idea because there should be some order for functions too. I think it is better to create separate section for functions which will have corresponding subsections depending on what they do. Like this:

• Fuctions
  • Clipboard
  • Console
  • Database
  • Filesystem
  • Graphics
  • GUI
  • Hotkeys
• Libraries
  • Clipboard
  • Console
  • Database
  • Filesystem
  • Graphics
  • GUI
  • Hotkeys

Is there a way to make collapsible sub-sections in markdown?
@G33kDude You can use some html in markdown but there are some restrictions. I dont know what are the exact restrictions but you can try to make it with html.

[rshipp]

Yeah, you can include HTML in Markdown and use Bootstrap's collapsible divs, like @vasili111 said. That kinda defeats the purpose of using Markdown though, and I'm pretty sure it won't work in a GitHub README, otherwise people would just be able to embed random JS.

Also, I'm not sure I understand why functions need a separate section. If you put a function in a file, doesn't that make it a library? I'd say it's just a library with only a single function. I don't know of any other language that makes a distinction like this, but maybe I'm just missing something that makes AHK different. ¯_(ツ)_/¯

[G33kDude]

I don't guess they really have to be separate, but would you call a room with a single book in it a library?

[joedf]

:p

[vasili111]

I like @rshipp ideas. Lets don't separate libraries and functions and use Libraries section for functions too. Just put functions in corresponding subsection of Libraries section.

[joedf]

Right-on! it's settled then. 👍