For the most part, I have mixed feelings about abbreviated words in code.  On 
one hand I value being concise
but also value clarity.

With this in mind, I propose we stop abbreviating `synchronize` in code and 
documentation.  It seems unnecessary.

Example:

Importer.sync()
-to-
Importer.synchronize()

and

Importer.last_sync
-to-
Importer.last_synchronized.

In documentation:

"The importer will perform a sync operation on the repository"
-to-
"The importer will synchronize the repository"

"The importer will log errors during sync"
-to-
"The importer will log synchronization errors"


This also has better symmetry with "publish".  We don't abbreviate as "pub".


I know it's pedantic but ...


Thoughts?

Attachment: signature.asc
Description: OpenPGP digital signature

_______________________________________________
Pulp-dev mailing list
[email protected]
https://www.redhat.com/mailman/listinfo/pulp-dev

Reply via email to