User: Password:
Subscribe / Log in / New account

explaining acronyms on first usage

explaining acronyms on first usage

Posted May 1, 2014 10:29 UTC (Thu) by tpo (subscriber, #25713)
In reply to: explaining acronyms on first usage by neilbrown
Parent article: Avoiding memory-allocation deadlocks

I see that you did not (yet?) update the article. Technical kernel LWN articles seem to quickly acquire "defacto reference documentation" status.

> I think I felt that the close proximity to a mention of "get_free_pages()" was sufficient to make it clear.

I agree. All the same I managed to read the whole article trying to understand the technical problems (which are far from trivial to see through) wondering until the end what GFP would be standing for... and finally googled it. Then I slapped my head.

But I think me being a stupid human being is not central here. The aim with documentation should be to make it as easy as possible for the reader to understand the technical issues and from that standpoint and this LWN article joining the "reference documentation" I think updating the article would be a good thing to do.


Thanks Neil!

(Log in to post comments)

Copyright © 2017, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds