Mir Blog: Writing efficient numerical code in D
Relja Ljubobratovic via Digitalmars-d-announce
digitalmars-d-announce at puremagic.com
Mon Dec 12 22:20:50 PST 2016
On Tuesday, 13 December 2016 at 05:27:01 UTC, Andrei Alexandrescu
wrote:
>
> I'm about to fall asleep, but I made a quick pass through the
> piece. Here are a few nits:
Thanks for an extensive feedback, Andrei! I've followed up 99% of
fixes given here[1], but unfortunately I'll be unavailable for
the rest of the day, so I'm passing the torch (or the hot potato)
to Ilya.
>
> * "we’ve been actively refactoring" -> define the team; so far
> the article referred to the author as a single person
I've done the coding, but couldn't have done it without Ilya's
consulting, so I put the 'Mir team' there. Hope thats ok.
>
> * "On my machine" -> "On a Core i7 laptop with xyz GB or RAM
> and xyz other relevant parameters..."
There are specs shown at the top of the post, so I thought it
would be best just to remove the "On my machine part". Again, I
hope that's alright.
>
> I suggest making two passes through the piece: (a) one pass
> should reduce fillers that are abundant ("as you can see", "as
> I'll show you", "as said in the docs"...) A few are fine
> (perhaps 2-3 in the whole article. Then (b) one pass looking
> for unified use of "I" (most likely: the author, use
> sparingly), "you" (the reader, use sparingly), and "we" (most
> likely: the author and reader looking together at something).
As I've demonstrated, I'm quite unexperienced with writing. :)
So, thanks for the feedback, I've learned a lot! If I catch some
time during the day, I'll be sure to take another glance at it!
>
> The results are terrific, congrats Ilya and Relja!
>
>
> Andrei
Thanks a lot Andrei!
Relja
[1] https://github.com/libmir/blog/pull/32
More information about the Digitalmars-d-announce
mailing list