Re: Website revamp?

[Maxim Nikulin]

24.08.2020 14:43, TEC wrote:
> Here's my overview of the current state of affairs
> + done :: nicer overall theme + done :: make site work on a variety of 
> form-factors + done :: nice features page (with animations!)  + done :: 
> prettier home page + done :: new "install" page + todo :: content for 
> home page + todo :: releases page + todo :: documentation + todo :: 
> contribute page + todo :: any missed pages/content

Certainly shortened version of features should appear on the main page. 
Some remarks. I do not know how much work is required to update animated 
images. Maybe someone will give better ideas, so do not hurry.

- Source code. I may be wrong but "C++" instead of "cpp" can be more 
friendly to older org versions bundled with emacs.

Concerning motivation, it seems to be convenient to keep small examples 
intended to check if some feature works or how to use particular 
language construct in a single file in preferred order instead of plenty 
of independent files in some directory.

- Tables. Consider specifying of explicit format, e,g, ";f5"

Another idea of a table that likely could be implemented in a better way

#+caption: Heron's method for $\sqrt{2}$
| iteration | approximation |    error |
|         ! |           cur |      err |
|-----------+---------------+----------|
|         0 |           1.0 |  4.1e-01 |
|         1 | 1.50000000000 | -8.6e-02 |
|         2 | 1.41666666667 | -2.5e-03 |
|         3 | 1.41421568628 | -2.1e-06 |
|         4 | 1.41421356238 | -1.0e-11 |
#+TBLFM: 
@4$1..$1=@-1+1::@4$2..$2=(0.5*(@-1+$arg/@-1));f11::@3$3..$3=$result - 
$cur;%.1e
#+CONSTANTS: arg=2.0 result=sqrt(2)

- Folding. Maybe it is better to show cycle for the top-level heading

# screen edge
last line of the previous section
* Section
Maybe single line
** Short subsection
a couple of lines
with some text
** Longer subsection
it
has more
# screen edge when everything is open
text
* Maybe something else

1. Initial state: everything is open
2. Cycle of visibility for top level section till section is open, 
subsections are folded
3 open first subsection

- Publishing. Something wrong with HTML export of the LaTeX macro, 
backslashes are exported in description (just as on orgmode.org). Empty 
braces are necessary only if space should be kept after a TeX command, 
e.g. "\TeX{} logo", Unsure if math mode separator is required, but it 
should allow omit braces. I have tried "@@latex:\\@@LaTeX". It works, 
but newline is inserted before. I believe, it is OK to use just text 
LaTeX in e.g. HTML.

Installation page

I am uncertain if it is applicable for other editors, but I would like 
to see name of vim plugin since ambiguity (or matter of taste) exists.. 
FAQ suggests other vim plugins. I do not remember if I saw vim-outliner 
somewhere on orgmode.org. I have not tried any of these plugins.

Certainly all above is an opinion and it is up to you whether to accept 
or to reject such suggestions.