Suggestion: A wiki page for all answered "Why don't you ...?"

[Magnus Ihse Bursie]

On 2025-01-19 18:24, Ethan McCue wrote:

> Following up to say: this will take more effort than I thought it 
> would. New years turned out to be a smidge optimistic.

You don't say? :-D

I think this is the reason that it has not been done already -- it 
requires a lot of work. It might be easier to start with something very 
simple, kind of MVP of a wiki page, just listing some bullet points of 
ideas and links to the email thread. Like what Archie suggested but even 
more simple. If this is available where everyone can contribute, 
hopefully it will be easier to crowdsource incremental improvements, 
than trying to write a complete, perfect document from scratch.

/Magnus


>
> On Fri, Dec 20, 2024, 9:26 AM Magnus Ihse Bursie 
> <magnus.ihse.bursie at oracle.com> wrote:
>
>     On 2024-12-13 04:02, Ethan McCue wrote:
>
>>     One practical trouble in assembling this is that the mailing
>>     lists aren't exactly indexed/searchable.
>
>     Yes, that is indeed annoying. :-(
>
>     To be able to search locally on your own computer, you can
>     download the archives using something like this:
>
>     wget -l 0  --mirror --convert-links --no-parent
>     https://mail.openjdk.org/pipermail/amber-dev/
>
>     This will give you all the mails as a <Year>-<Month>.txt file.
>
>     Our CDN seems to be throttling wget, so you might have do to add
>     something like
>     "--user-agent=work-around-missing-searchable-archive" to the
>     command line...
>
>>     I'll make it my project to put something together by new years
>>     though.
>
>     That's great to hear. Thank you Ethan!
>
>     /Magnus
>
>>
>>     On Fri, Dec 13, 2024, 6:26 AM Louis Wasserman
>>     <lowasser at google.com> wrote:
>>
>>         Just seeing that it hasn't been mentioned, Guava's Idea
>>         Graveyard is an example of this specific flavor of thing:
>>         https://github.com/google/guava/wiki/IdeaGraveyard. (It's
>>         pretty old, though, which reflects some of the downsides.)
>>
>>         On Thu, Dec 12, 2024 at 10:34 AM Archie Cobbs
>>         <archie.cobbs at gmail.com> wrote:
>>
>>             On Thu, Dec 12, 2024 at 10:07 AM Brian Goetz
>>             <brian.goetz at oracle.com> wrote:
>>
>>                 There is the amber-docs repo which gets published to
>>                 `openjdk.org/projects/amber`
>>                 <http://openjdk.org/projects/amber>, which is
>>                 probably a better place to put it, and people can
>>                 contribute via PRs.
>>
>>
>>             I think putting something online under amber-docs is a
>>             great idea - especially the part where people can
>>             contribute using PR's, which fosters decentralized
>>             collaboration on the maintenance of the list.
>>
>>             While it would be ideal to have a complete directory of
>>             ideas with accompanying summaries of all that has been
>>             discussed, we should probably start with something
>>             simpler and more maintainable.
>>
>>             Here's a proposal: Have a list of "previously discussed
>>             ideas". Each idea has a one line description, a one
>>             paragraph summary, an optional example, and a
>>             bullet-point list of one or more links to the thread(s)
>>             in the archive that contain all the gory details of the
>>             discussion.
>>
>>             Here's a simple example...
>>
>>             *Idea:* Using switch statements for if/else control flow
>>
>>             *Description:* Support "switches on nothing" where the
>>             cases simply provide the conditions on which to execute
>>             various code branches.
>>
>>             *Example:*
>>
>>                 public double toInches(String value) {
>>             switch {
>>                     case when value.endsWith("mm") -> return
>>             0.0393701 * Integer.parseInt(value.substring(0,
>>             value.length() - 2));
>>                     case when value.endsWith("ft") -> return 12 *
>>             Integer.parseInt(value.substring(0, value.length() - 2));
>>                     case when value.endsWith("light-years") -> return
>>             3.725e+17 * Integer.parseInt(value.substring(0,
>>             value.length() - 2));
>>                     default -> throw new
>>             IllegalArgumentException("can't parse value");
>>                     }
>>                 }
>>
>>             *Discussion:*
>>
>>               * https://mail.openjdk.org/pipermail/amber-dev/2024-October/008939.html
>>
>>
>>             Just now seeing Eirik's reference to Project Jigsaw's
>>             Issue Summary document. I like this even better but
>>             someone would have to step up and take ownership.
>>
>>             -Archie
>>
>>             -- 
>>             Archie L. Cobbs
>>
>>
>>
>>         -- 
>>         Louis Wasserman (he/they)
>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/amber-dev/attachments/20250306/de9b7875/attachment-0001.htm>