Skip to content

Instantly share code, notes, and snippets.

@Lokathor

Lokathor/channels-rfc.md

Last active February 27, 2019 08:10
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Lokathor/f63b9331795d8c6f8e51394e85430a03 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Lokathor/f63b9331795d8c6f8e51394e85430a03 to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. Lokathor revised this gist Feb 27, 2019. 1 changed file with 1 addition and 1 deletion.
    2 changes: 1 addition & 1 deletion channels-rfc.md
    View file
    Original file line number Diff line number Diff line change
    @@ -57,4 +57,4 @@ None that I can think of.
    # Future possibilities
    [future-possibilities]: #future-possibilities

    We can always add more channels to this section. WASM, GBA, Switch, etc.
    We can always add more channels to this section later. WASM, GBA, Switch, DOS, etc.
  2. Lokathor created this gist Feb 27, 2019.
    60 changes: 60 additions & 0 deletions channels-rfc.md
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,60 @@
    - Feature Name: platform_channel_section
    - Start Date: 2019-02-27
    - RFC PR: (leave this empty)
    - Rust Issue: (leave this empty)

    # Summary
    [summary]: #summary

    We add a whole new section to the channels list for Platform channels. It contains one channel for each major target platform (Win, Mac, etc).

    # Motivation
    [motivation]: #motivation

    Currently a lot of lore about the quirks of using Rust on a particular platform are spread all around. Rust still has to interact with a lot of platform specific libs, and it would be very good to have a place where people can build knowledge around a target platform they want to use.

    # Guide-level explanation
    [guide-level-explanation]: #guide-level-explanation

    Also in the channel list is a "Platforms" section. In this section is one channel per major platform that you might use Rust on. These are most helpful if you need to get help with a particular platform's native libs, setup and building, etc.

    # Reference-level explanation
    [reference-level-explanation]: #reference-level-explanation

    The `Platforms` channel section comes after `Rust Extra` and has one channel per platform that Rust can target. The proposed channel ordering roughly follows each platform's [global market share](http://gs.statcounter.com/os-market-share):

    * Android
    * Windows
    * iOS
    * OS-X
    * Linux

    The description for each channel can simply be "Discussion about Rust on %OS_NAME%"

    # Drawbacks
    [drawbacks]: #drawbacks

    Almost none. People can mute the channels that they don't want to hear about.

    I suppose it uses 5 slots out of out 500 channel maximum.

    # Rationale and alternatives
    [rationale-and-alternatives]: #rationale-and-alternatives

    * We could always not add any new channels.
    * We could add the platform channels in an existing channel group.

    # Prior art
    [prior-art]: #prior-art

    We already have a few "specialty" channels in the Rust Extra section.

    # Unresolved questions
    [unresolved-questions]: #unresolved-questions

    None that I can think of.

    # Future possibilities
    [future-possibilities]: #future-possibilities

    We can always add more channels to this section. WASM, GBA, Switch, etc.