-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathdevelopment.html
159 lines (150 loc) · 8.37 KB
/
development.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
<!DOCTYPE html>
<html lang="en" data-content_root="./">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Development — FriCAS</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="_static/classic.css?v=514cf933" />
<link rel="stylesheet" href="_static/style.css" type="text/css" />
<script src="_static/documentation_options.js?v=a44cb687"></script>
<script src="_static/doctools.js?v=888ff710"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="SPAD Style Guide" href="spadstyleguide.html" />
<link rel="prev" title="Examples" href="examples.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="spadstyleguide.html" title="SPAD Style Guide"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="examples.html" title="Examples"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">FriCAS</a> »</li>
<li class="nav-item nav-item-this"><a href="">Development</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="development">
<h1>Development<a class="headerlink" href="#development" title="Link to this heading">¶</a></h1>
<p>Development is currently driven by the needs and wishes of the various
contributors.</p>
<p>Bug reports are collected through
<a class="reference external" href="https://github.com/fricas/fricas/issues">issues</a>
at github, but can also be sent to the <a class="reference external" href="https://groups.google.com/forum/#!forum/fricas-devel">FriCAS mailing list</a>.</p>
<p>In fact, almost all public discussion currently happens on that list.</p>
<p>You can get the sources from the <a class="reference external" href="https://github.com/fricas/fricas">FriCAS git repository</a>:</p>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>git clone https://github.com/fricas/fricas.git
</pre></div>
</div>
<p>Better, press the fork button on the <a class="reference external" href="https://github.com/fricas/fricas">FriCAS git repository</a> and send
an ordinary <a class="reference external" href="https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request">Github pull request</a>.</p>
<section id="code-review-policy">
<h2>Code review policy<a class="headerlink" href="#code-review-policy" title="Link to this heading">¶</a></h2>
<p>Normally patches go to the <a class="reference external" href="https://groups.google.com/forum/#!forum/fricas-devel">FriCAS mailing list</a> for review or are reviewed
in a <a class="reference external" href="https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/creating-an-issue-or-pull-request">Github pull request</a>.</p>
<p>A patch should go in as reviewed—if there is need for change new
patch should be provided.</p>
<p>Obvious things can go in without review. Really minor changes to
patches also can go without extra round of review.</p>
<p>Of course patches should satisfy technical requirements (pass test,
update documentation when appropriate, contain tests for changes).</p>
<p>Patches should be logical unit of change. Do not join unrelated things
unless it is a cleanup type patch that functionally should be a no-op.</p>
<p>Do not split patches that implement some functionality into small
steps—if several patches have a common purpose and there are
dependencies between them, then they probably should go in as one
patch. This is not a hard rule, it makes sense to split really large
patches (say more than one thousand lines) and sometimes part of the
functionality is ready and may be committed before the feature is
complete.</p>
</section>
<section id="other-resources">
<h2>Other resources<a class="headerlink" href="#other-resources" title="Link to this heading">¶</a></h2>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="spadstyleguide.html">SPAD Style Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="contributors.html">Contributors</a></li>
</ul>
</div>
<ul class="simple">
<li><p><a class="reference external" href="http://wiki.fricas.org/DebuggingFriCAS">Debugging FriCAS</a></p></li>
<li><p><a class="reference external" href="http://wiki.fricas.org/LanguageDifferences">Language Differences</a></p></li>
<li><p><a class="reference external" href="fricas-notebooks/system-command-set.html">The )set command</a></p></li>
<li><p><a class="reference external" href="http://www.aldor.org/docs/aldorug.pdf">Aldor User Guide</a></p></li>
<li><p><a class="reference external" href="http://fricas.sourceforge.net/doc/boot.notes">Description of the BOOT language (txt)</a></p></li>
<li><p><a class="reference external" href="http://www.euclideanspace.com/prog/scratchpad/internals/boot/index.htm">Description of the BOOT language</a></p></li>
</ul>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table of Contents</a></h3>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="api/index.html">FriCAS API</a></li>
<li class="toctree-l1"><a class="reference internal" href="features.html">Features</a></li>
<li class="toctree-l1"><a class="reference internal" href="download.html">Download</a></li>
<li class="toctree-l1"><a class="reference internal" href="help.html">Help</a></li>
<li class="toctree-l1"><a class="reference internal" href="examples.html">Examples</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="citation.html">Citation</a></li>
<li class="toctree-l1"><a class="reference internal" href="history.html">History</a></li>
</ul>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/development.rst.txt"
rel="nofollow">Show Source</a></li>
<li><a href="https://github.com/fricas/fricas/blob/master/src/doc/sphinx/source/development.rst"
rel="nofollow">Show on GitHub</a></li>
<li><a href="https://github.com/fricas/fricas/edit/master/src/doc/sphinx/source/development.rst"
rel="nofollow">Edit on GitHub</a></li>
</ul>
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="spadstyleguide.html" title="SPAD Style Guide"
>next</a> |</li>
<li class="right" >
<a href="examples.html" title="Examples"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">FriCAS</a> »</li>
<li class="nav-item nav-item-this"><a href="">Development</a></li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2007-2024, FriCAS Team.
</div>
</body>
</html>