Improve 'opening directories' (multi-platform) wording in docs' introduction about flight-manual.atom.io

[lee-dohm]

I think this is platform-dependent. On OS X, using File >> Open allows one to either open a directory or a file and there is no File >> Open Folder... menu item.

[dcarral]

Hmmm, exactly. https://github.com/atom/atom/tree/29a1fbc45f4bf2be059fb827204994e06c1437f3/menus

Good catch, I even didn't think about it! Thanks @lee-dohm ;)

[lee-dohm]

You're welcome 😎

[dcarral]

Knowing this, how could we solve this issue in a elegant manner?

Without further reading/testing I don't know if:

• This fact (the platform-specific functionality and its possible misalignment with the docs content) is mentioned somewhere in the document.
• Wording for "menu items" is at least consistent (same platform) across the book.

[lee-dohm]

The majority of the documentation has been written from the OS X perspective. There is a discussion around strategies for handling multiple platforms (#16) but no real progress has been made on that front. The way I've been writing these things in most communications is as an additional note like this:

To open a directory, choose the menu item ''File >> Open'' on OS X or ''File >> Open Folder'' on other platforms and select a directory from the dialog.

[dcarral]

Thank you very much again Lee. As you might have noticed I wasn't aware of current discussions/roadmap at all, sorry for that.

I've already updated this PR including the suggested wording instead of the Linux/Windows-specific one.

And now that everything is in context here, let's keep the discussion regarding the "multi-platform keybindings" @ #16 ;)

[lee-dohm]

As you might have noticed I wasn't aware of current discussions/roadmap at all, sorry for that.

There's no need to apologize, we don't expect everyone to keep up with every minute detail of the project 😆

it looks like, at the moment, there's not planned work for #16 yet, right?

To my knowledge, not at the moment, no.