add docs for expanded attribute
rename expanded to extended
extended attribute under development caution