Daniel Kinzler has uploaded a new change for review.

  https://gerrit.wikimedia.org/r/323402

Change subject: Document checklist for extending entities.
......................................................................

Document checklist for extending entities.

Change-Id: I1b0f7c3d1c58227b3326240fb2a1bbd1e58535a7
---
A docs/extending-entities.wiki
1 file changed, 24 insertions(+), 0 deletions(-)


  git pull ssh://gerrit.wikimedia.org:29418/mediawiki/extensions/Wikibase 
refs/changes/02/323402/1

diff --git a/docs/extending-entities.wiki b/docs/extending-entities.wiki
new file mode 100644
index 0000000..a0de280
--- /dev/null
+++ b/docs/extending-entities.wiki
@@ -0,0 +1,24 @@
+This is a checklist of things that need doing when adding a new field to an 
existing entity type.
+
+* Add a provider interface
+* Add to entity as an attribute and add getter and setter (implement the 
provider interface)
+* Add to content as part of FooContent::isStub
+* Add to Special:NewFoo if needed upon creation
+* Consider in equals() method of the Entity
+* Consider in __clone() method of the Entity
+* Consider in isEmpty() method of the Entity
+* Add support to FooSerializer
+* Add support to FooDeserializer
+* Add support to FooPatcher
+* Add support to FooDiffer
+* Add support in FooView (extends EntityView)
+
+CAVEAT (as of November 2016): For the below parts of Wikibase, there are no 
extension
+interfaces yet for handling additional fields of entities. Fields of entity 
types known
+to Wikibase itself can be hardcoded here, but for supporting entity types 
defined in
+other extensions, plug-in interfaces still need to be added.
+
+* Add to RDF mapping (not currently pluggable!)
+* Add Validator (not currently pluggable)
+* Add ChangeOp for updating (not currently pluggable) (must work with 
wbeditentity)
+* Add handling (or suppression) to EntityChangeFactory (not currently 
pluggable)
\ No newline at end of file

-- 
To view, visit https://gerrit.wikimedia.org/r/323402
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings

Gerrit-MessageType: newchange
Gerrit-Change-Id: I1b0f7c3d1c58227b3326240fb2a1bbd1e58535a7
Gerrit-PatchSet: 1
Gerrit-Project: mediawiki/extensions/Wikibase
Gerrit-Branch: master
Gerrit-Owner: Daniel Kinzler <[email protected]>

_______________________________________________
MediaWiki-commits mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits

Reply via email to