Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Non-gnu apps that don't usually come with unix-likes should not be grouped by OS #61

Closed
phillips1012 opened this issue Jan 31, 2014 · 2 comments
Labels
architecture Organization of the pages per language, platform, etc. invalid Issues or PRs invalid for this project.

Comments

@phillips1012
Copy link
Contributor

I think non-OS specific things should be separated into a different category. For example, pacman can compile and run on BSD, so it's not specific to linux, and a lot of other unix-like programs can be cross-compiled.

However, things like ls and cd should be in the common category, but distro-specific things like dpkg and pacman should be in the apps category.

@rprieto
Copy link
Contributor

rprieto commented Mar 5, 2014

Hi @phillips1012 , sorry it's been a while but we've made some good progress behind the scenes.
This repo now only contains the actual pages, and clients are maintained separately.

What would you think of the following structure? We're trying to keep it simple for clients, and avoid arbitrary or debatable splits:

pages
   |__ tar.md         # common tar tool
   |__ ssh.md         # default gnu version of ssh
   |__ ssh.osx.md     # OSX version of ssh
   |__ emerge.md      # linux only tool
   |__ npm.md         # general app that cross-compiles

The idea is that every command goes at the top level, as <command>.md. As you said, many commands can be cross-compiled, and sometimes you might just want to look up apt-get while on a Mac.

Still, commands that have several versions can be overridden as ssh.osx.md, in which case tldr ssh will pick that one over the generic one if you're on that platform.

@rprieto
Copy link
Contributor

rprieto commented Oct 2, 2014

Closing, we should consolidate this discussion in #190

@rprieto rprieto closed this as completed Oct 2, 2014
@CleanMachine1 CleanMachine1 added architecture Organization of the pages per language, platform, etc. invalid Issues or PRs invalid for this project. labels Jul 10, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
architecture Organization of the pages per language, platform, etc. invalid Issues or PRs invalid for this project.
Projects
None yet
Development

No branches or pull requests

3 participants