annotate pages/support-expectations.md @ 271:3ce19581b946

LICENSE: Add "GPL-3.0-or-later" for code
author Kai Torben Ohlhus <k.ohlhus@gmail.com>
date Mon, 21 Feb 2022 17:32:38 +0900
parents c8126c010d67
children 2e13395adcc0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
215
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
1 ---
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
2 layout: page
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
3 title: Support Expectations
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
4 permalink: support-expectations
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
5 ---
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
6
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
7 Octave is a capable free software system for numerical computing developed
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
8 primarily by a community of **volunteers**.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
9 As good as Octave is,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
10 there are certainly some flaws and a lot of room for improvement.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
11 Most people who use Octave understand these things
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
12 and know that if they work together with the community bugs will be fixed,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
13 features will be added,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
14 and Octave will improve over time.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
15 Working with people who have this kind of attitude is fun and rewarding.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
16
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
17 Unfortunately,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
18 there are a few people who behave as though the community owes them support as
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
19 well as a 100% Matlab compatible system,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
20 all at zero cost.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
21 **Working with these people is no fun.**
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
22 If you approach the Octave community this way,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
23 you are sure to be disappointed.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
24 You should also not be surprised when your requests for help are ignored.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
25
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
26
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
27 ### Development Group
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
28
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
29 People sometimes think that Octave is developed by some large team of well-paid
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
30 programmers.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
31 Nothing could be further from the truth.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
32 Most of the initial development of Octave was done by one person over several
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
33 years.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
34 Since then,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
35 there have been at most a half-dozen or so volunteers working on Octave
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
36 at any one time.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
37 You can see who has done most of the work by looking through the
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
38 [development history](https://hg.savannah.gnu.org/hgweb/octave)
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
39 (prior to February 2008 it is best to look in the old `ChangeLog` files).
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
40 Currently,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
41 none of the Octave developers are paid to work on Octave directly.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
42
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
43 If you would like to see Octave moving forward more quickly,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
44 then contribute to its development,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
45 either by working on the project yourself,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
46 or by [donating funds]({{ "donation.html" | relative_url }}).
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
47 With sufficient funding,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
48 the Octave project would be able to pay a few developers to work on it full
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
49 time.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
50
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
51
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
52 ### Help
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
53
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
54 When asking for help on Discourse or IRC channel,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
55 or reporting a bug,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
56 remember that the people helping you are Octave users just like you
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
57 who are volunteering their time.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
58 They are not paid support staff.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
59 Use meaningful subject lines.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
60 Try to ask clear questions.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
61 Be precise about the problems you are having.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
62
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
63
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
64 ### Bugs
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
65
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
66 No software is perfect,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
67 and Octave is no exception.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
68 You can search the list of bug reports to see what problems have been reported.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
69 In looking at the list,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
70 you might also noticed the number of problems that have been *fixed*.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
71 Nearly all of these problems have been fixed by volunteers.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
72 If you find a problem,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
73 you are encouraged to [report it]({{ "bugs.html" | relative_url }}).
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
74 Your report can help to improve Octave,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
75 but you should not think of the bug tracker as your personal support line.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
76
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
77 If you depend on Octave and absolutely must have prompt responses to problem
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
78 reports,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
79 you should consider paying for
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
80 [commercial support]({{ "commercial-support.html" | relative_url }}).
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
81
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
82
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
83 ### Features
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
84
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
85 When we say that Octave is "mostly compatible" with Matlab,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
86 we mean that the language that it accepts is similar enough that a substantial
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
87 amount of code written for Matlab can also run in Octave without needing to be
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
88 changed.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
89 But Octave does not have all the features of Matlab,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
90 and it is unlikely that it ever will.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
91 Given that Matlab is developed in secret and Octave developers only find out
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
92 about new Matlab features when new versions of Matlab are released,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
93 it is clearly impossible for Octave to have new Matlab features as soon as they
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
94 are available in Matlab.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
95
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
96 In most cases,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
97 Octave has the features that it does because someone decided to add them
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
98 because they needed them.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
99 If you have the programming skills perhaps you can add the features you need.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
100 If you not,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
101 then consider paying for someone to implement the feature for you.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
102 Most people who provide
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
103 [commercial support]({{ "commercial-support.html" | relative_url }})
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
104 services for Octave will also take on custom programming projects.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
105
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
106 Even if you don't have the expertise required to implement new features or
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
107 can't pay for someone to do the work for you,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
108 you may submit feature requests to the bug tracker.
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
109 But you should understand that unless you are paying for someone to to add the
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
110 feature,
dedb85c54245 Reorganize homepage.
Kai T. Ohlhus <k.ohlhus@gmail.com>
parents:
diff changeset
111 no one is obligated to do it for you.