Java

1
name: Feature Enhancement Request
2
description: I want to make an existing feature better
3
labels: ["type=enhancement"]
4
body:
5
  - type: markdown
6
    attributes:
7
      value: >
8
        Filing feature requests is one of the most popular ways to contribute to Guava.
9

10

11
        Be aware, though: most feature requests are not accepted, even if they're suggested by
12
        a full-time Guava team member. [Feedback](https://stackoverflow.com/a/4543114) from our
13
        users indicates that they really appreciate Guava's high power-to-weight ratio. It's
14
        important to us to keep Guava as easy to use and understand as we can. That means boiling
15
        features down to compact but powerful abstractions, and controlling feature bloat carefully.
16

17
  - type: textarea
18
    attributes:
19
      label: API(s)
20
      description: Which existing classes or methods do you want to improve?
21
      placeholder: e.g., `com.google.common.collect.ImmutableList::of`
22
      render: java
23
    validations:
24
      required: true
25

26
  - type: textarea
27
    attributes:
28
      label: How do you want it to be improved?
29
    validations:
30
      required: true
31

32
  - type: textarea
33
    attributes:
34
      label: Why do we need it to be improved?
35
    validations:
36
      required: true
37

38
  - type: textarea
39
    attributes:
40
      label: Example
41
      description: >
42
        Please provide an example usage of the feature that would be different with the improvement.
43
      render: java
44
    validations:
45
      required: true
46

47
  - type: textarea
48
    attributes:
49
      label: Current Behavior
50
      description: What does the feature currently do?
51
    validations:
52
      required: true
53

54
  - type: textarea
55
    attributes:
56
      label: Desired Behavior
57
      description: What do you want it to do instead?
58
    validations:
59
      required: true
60

61
  - type: markdown
62
    attributes:
63
      value: >
64
        Did you *actually* encounter the need for this enhancement in a real-world scenario, or does
65
        it just seem like a sensible behavior for the feature to have?
66

67

68
        Before we make significant changes to existing features in Guava, we really want to be sure
69
        that it's for a use case that actually comes up in the real world. We want to hear the
70
        real-world use case so the community can discuss and debate whether this feature is actually
71
        the *best* way to address the real use case, or whether or not a different approach might be
72
        more appropriate.
73

74

75
        It's okay if you can't provide complete context on a use case. We understand if you are not
76
        able to discuss the full details of what you're working on.
77

78

79
        But Guava aims to provide functionality that is useful across boundaries of projects,
80
        companies, or even industries — utilities useful for a sizable proportion of all Java
81
        programmers everywhere. If you can give enough detail such that any of us can imagine coming
82
        across a similar need in our own work, that's extremely helpful in studying how broadly
83
        useful the proposed change will be.
84

85
  - type: textarea
86
    attributes:
87
      label: Concrete Use Cases
88
      description: Please provide use cases that actually came up in the real world.
89
    validations:
90
      required: true
91

92
  - type: checkboxes
93
    attributes:
94
      label: Checklist
95
      options:
96
        - label: >
97
            I agree to follow the
98
            [code of conduct](https://github.com/google/.github/blob/master/CODE_OF_CONDUCT.md).
99
          required: true
100
        - label: >
101
            I have read and understood the [contribution
102
            guidelines](https://github.com/google/guava/wiki/HowToContribute#feature-requests).
103
          required: true
104
        - label: >
105
            I have read and understood
106
            [Guava's philosophy](https://github.com/google/guava/wiki/PhilosophyExplained), and
107
            I strongly believe that this proposal aligns with it.
108
          required: true
109