Re: On topic? Guidelines for math writing

2018-08-10 Thread Offray Vladimir Luna Cárdenas
Thanks a lot for this link. Cheers, Offray On 06/08/18 10:06, Edward K. Ream wrote: > This page > > contains guidelines for good mathematical writing. Imo, it generalizes > pretty well to any kind of technical writing. > > The

Re: On topic? Guidelines for math writing

2018-08-07 Thread Edward K. Ream
On Mon, Aug 6, 2018 at 6:32 PM, Rob wrote: That's a great article and highlights something I preach/teach all the > time; know your audience. I also think there's a third, and significantly > larger audience of 'users'. > I agree. I omitted this third audience because presumably they won't be

Re: On topic? Guidelines for math writing

2018-08-06 Thread Rob
That's a great article and highlights something I preach/teach all the time; know your audience. I also think there's a third, and significantly larger audience of 'users'. Perhaps most of them aren't interested in the code base itself, but simply in how Leo works. I count myself as part of

Re: On topic? Guidelines for math writing

2018-08-06 Thread vitalije
On Monday, August 6, 2018 at 5:06:11 PM UTC+2, Edward K. Ream wrote: > > This page > contains guidelines for good mathematical writing. Imo, it generalizes > pretty well to any kind of technical writing. > > Great resource. I've

On topic? Guidelines for math writing

2018-08-06 Thread Edward K. Ream
This page contains guidelines for good mathematical writing. Imo, it generalizes pretty well to any kind of technical writing. The first principle, "Know your audience" applies to our recent discussions of code refactoring and