Platform cheatsheet wiki page.

[b-aaz]

Describe the idea

I'm suggesting a knowledge base, for reading quick information about a platform that is relevant to XLibre and its development.
There can be a page dedicated to each OS, and then in a table entries be added for each bit of information.
The table could include but is not limited to the following:

• What is the input driver of choice in this platform?
• What is the 3rd party software path prefix?
• What distribution of X11 does a platform use?
• What are the graphic layers supported?
• What are the hacks and tweaks made to run X11 on this platform?
• What are some of the missing headers in the platform? Are there any wrappers around them?
• Links to relevant pages with necessary information.

@callmetango what do you think?

It should be done because

Most contributors and developers here have mastered the insides and outs of a single ecosystem and that is usually Linux.
But XLibre is a cross platform software, knowledge of some facts about different OSs and platforms is vital for it's development.
Usually these facts can be gathered by surfing the interwebs but that takes a long time and usually is not done.
Having all useful info about a platform in a single location can help speedup this process and in turn encourage the developers to go and look for them.

What are the alternatives?

This could be a single wiki page, a single table, collection of pages and ... .
I'm just suggesting the broad idea.

Additional context

I had this idea after dealing with this issue on FreeBSD.

Extra fields

• I have checked the existing New Ideas, RFCs Of The Core Team, Ideas Soon To Be Addressed and Someday Ideas
• I have read the Contributing Guidelines
• I'd like to work on this idea

[callmetango]

I really like the idea! Really, very good.

And it matches with the an idea of mine to ensure XLibre works on the platforms Xorg used to work as stated in Xorg(1x) manual page. Quote:

Xorg operates under a wide range of operating systems and hardware platforms. The Intel x86 (IA32) architecture is the most widely supported hardware platform. Other hardware platforms include Compaq Alpha, Intel IA64, SPARC and PowerPC. The most widely supported operating systems are the free/OpenSource UNIX-like systems such as Linux, FreeBSD, NetBSD and OpenBSD. Commercial UNIX operating systems such as Solaris (x86) and UnixWare are also supported. Other supported operating systems include LynxOS, and GNU Hurd. Darwin and Mac OS X are supported with the XDarwin(1) X server. Win32/Cygwin is supported with the XWin X server.

Sure, XLibre should work on these platforms as well since noone kicked them out but we need proof by testing XLibre in the real world.

[b-aaz]

OK, nice!
How do you suggest we structure this? A wiki section with pages for each platforms?

[callmetango]

Yes, this sounds good. Unfortunately, Github does not support Folders or grouping pages in GitHub Wikis · community · Discussion #23914, but we can work around this by using this tool Home · adriantanasa/github-wiki-sidebar Wiki or edit the sidebar menu by hand.

My suggestion for the top-level page name was "Crossdev" since the section is all about Cross-platform software - Wikipedia. Subsequent pages could be named "Crossdev: FreeBSD", "Crossdev: Linux", ...

What do you think?

[b-aaz]

LGTM, did not know that tool existed, thanks!

[callmetango]

45 minutes ago: Me neither. 😉 You're welcome!