Talk:Construction industry knowledge standard - Revision history

Designing Buildings at 09:17, 25 November 2018

2018-11-25T09:17:20Z

← Older revision		Revision as of 09:17, 25 November 2018
Line 82:		Line 82:
	-----		-----
	Look at CrossMark system.		Look at CrossMark system.
		+
		+	-----
		+	Use only UTF- characters.
		+
		+	-----
		+	Record when the document was originally created - is it maintained / current / archived.

Designing Buildings at 13:38, 8 March 2018

2018-03-08T13:38:47Z

← Older revision		Revision as of 13:38, 8 March 2018
Line 54:		Line 54:
	-----		-----
	Is it better to have the subject in the URL as well as the page title?		Is it better to have the subject in the URL as well as the page title?
−
−	~~-----~~
−	~~Give images (and other files) a plain language name that is east to remember and index but does not include symbols (such as apostrophes or dashes) that might confuse some image handlers.~~

	-----		-----
	Is there a way of flagging up / informing the author when a piece of knowledge is no longer current?		Is there a way of flagging up / informing the author when a piece of knowledge is no longer current?
−
−	~~-----~~
−	~~Use standard fonts.~~

	-----		-----

Designing Buildings at 15:23, 7 March 2018

2018-03-07T15:23:03Z

← Older revision		Revision as of 15:23, 7 March 2018
Line 20:		Line 20:

	-----		-----
−	Linked content should be in native or open format.	+	Linked content (such as the data from which a graph has been created) should be in native or open format.

	-----		-----
Line 30:		Line 30:
	-----		-----
	Pull out captions should not be used. It is generally not clear where they fit in the flow of the text.		Pull out captions should not be used. It is generally not clear where they fit in the flow of the text.
−
−	~~-----~~
−	~~Do not say image below, above, left etc. Refer to an actual figure number.~~

	-----		-----
Line 38:		Line 35:

	-----		-----
−	The use of future tense is limiting.	+	The use of the future tense in text is limiting. It will become the past.

	-----		-----
Line 51:		Line 48:
	-----		-----
	Some documents are private, or copyrighted - which licenses are suitable?		Some documents are private, or copyrighted - which licenses are suitable?
−
−	~~-----~~
−	~~Text should not refer to images / tables etc that are above, left, right or below, as this restricts formatting. They should refer to a number or title.~~

	-----		-----
Line 60:		Line 54:
	-----		-----
	Is it better to have the subject in the URL as well as the page title?		Is it better to have the subject in the URL as well as the page title?
−
−	~~-----~~
−	~~Web addresses need to include the http:// bit~~

	-----		-----

Designing Buildings at 10:11, 14 January 2016

2016-01-14T10:11:50Z

← Older revision		Revision as of 10:11, 14 January 2016
Line 1:		Line 1:
		+	To add your thoughts to this discussion page, click 'Add a comment' above.

−	~~'''To add your thoughts to this discussion page, click 'Add a comment' above.'''~~	+	-----
−		+
−	----	+
−		+
	It has been suggested that the standard should be more prescriptive about the structure of documents. For example, requiring the preparation of an abstract of a certain length.		It has been suggested that the standard should be more prescriptive about the structure of documents. For example, requiring the preparation of an abstract of a certain length.

−	----	+	-----
−		+
	It has been suggested that the section on images should be expanded to make clear that images should be provided separately at high resolution so that they can be re-sized without loss of quality and so they can be properly indexed and licensed.		It has been suggested that the section on images should be expanded to make clear that images should be provided separately at high resolution so that they can be re-sized without loss of quality and so they can be properly indexed and licensed.

−	----	+	-----
−		+
	Should the standard be developed to include a system for tracking the provenance of knowledge, that is, where did it come from and where else is it used? This might be done by allocating a unique identifier to each piece of knowledge.		Should the standard be developed to include a system for tracking the provenance of knowledge, that is, where did it come from and where else is it used? This might be done by allocating a unique identifier to each piece of knowledge.

−	----	+	-----
−		+
	Include instructions for how to attach licences to knowledge.		Include instructions for how to attach licences to knowledge.

−	----	+	-----
−		+
	Images need to be provided separately and separately indexed so that they are searchable.		Images need to be provided separately and separately indexed so that they are searchable.

−	----	+	-----
−		+
	How should very long documents be prepared? Should they be broken into chapters or presented as one very long file? Should a summary be published following a standard format, and linked to the full document?		How should very long documents be prepared? Should they be broken into chapters or presented as one very long file? Should a summary be published following a standard format, and linked to the full document?

−	----	+	-----
−		+
	Linked content should be in native or open format.		Linked content should be in native or open format.

−	----	+	-----
−		+
	Images should be provided as image files, not for example as word objects.		Images should be provided as image files, not for example as word objects.

−	----	+	-----
−		+
	Bulleted lists and numbered lists should be properly formatted lists, not normal paragraphs with bullet or number characters at the beginning.		Bulleted lists and numbered lists should be properly formatted lists, not normal paragraphs with bullet or number characters at the beginning.

−	----	+	-----
−		+
	Pull out captions should not be used. It is generally not clear where they fit in the flow of the text.		Pull out captions should not be used. It is generally not clear where they fit in the flow of the text.

−	----	+	-----
−		+
	Do not say image below, above, left etc. Refer to an actual figure number.		Do not say image below, above, left etc. Refer to an actual figure number.

−	----	+	-----
−		+
	Images must be part of the flow. Not separated from the text to which they relate, or with text wrapped, or in separate windows.		Images must be part of the flow. Not separated from the text to which they relate, or with text wrapped, or in separate windows.

−	----	+	-----
−		+	The use of future tense is limiting.
−	The use of future tense is limiting.~~<br/>~~	+
−		+
−	~~----~~	+

		+	-----
	Be more prescriptive about how to make text accessible to / usable by a wider audience.		Be more prescriptive about how to make text accessible to / usable by a wider audience.

−	----	+	-----
−		+
	Is there a way of making references non-sequential so that sections of content can be re-used without the need to re-number references?		Is there a way of making references non-sequential so that sections of content can be re-used without the need to re-number references?

−	----	+	-----
−		+
	Can it be tailored more to report writing?		Can it be tailored more to report writing?

−	----	+	-----
−		+
	Some documents are private, or copyrighted - which licenses are suitable?		Some documents are private, or copyrighted - which licenses are suitable?

−	----	+	-----
−		+
	Text should not refer to images / tables etc that are above, left, right or below, as this restricts formatting. They should refer to a number or title.		Text should not refer to images / tables etc that are above, left, right or below, as this restricts formatting. They should refer to a number or title.

−	----	+	-----
−		+
	Think about what people are looking for rather than what you can publish. Start typing your subject into google and see what it predicts you are looking for.		Think about what people are looking for rather than what you can publish. Start typing your subject into google and see what it predicts you are looking for.

−	----	+	-----
−		+
	Is it better to have the subject in the URL as well as the page title?		Is it better to have the subject in the URL as well as the page title?

−	----	+	-----
−		+
	Web addresses need to include the http:// bit		Web addresses need to include the http:// bit

−	----	+	-----
−		+
	Give images (and other files) a plain language name that is east to remember and index but does not include symbols (such as apostrophes or dashes) that might confuse some image handlers.		Give images (and other files) a plain language name that is east to remember and index but does not include symbols (such as apostrophes or dashes) that might confuse some image handlers.

−	----	+	-----
−		+
	Is there a way of flagging up / informing the author when a piece of knowledge is no longer current?		Is there a way of flagging up / informing the author when a piece of knowledge is no longer current?

−	----	+	-----
−		+
	Use standard fonts.		Use standard fonts.

−	----	+	-----
−		+
	Documents should be provided in native format or an open format, rather than as a pdf which is difficult to re-process or use.		Documents should be provided in native format or an open format, rather than as a pdf which is difficult to re-process or use.

−	----	+	-----
−		+
	Some knowledge is proprietary, and whilst it could be produced following a standard, it would not be accessible or licensed for use by others.		Some knowledge is proprietary, and whilst it could be produced following a standard, it would not be accessible or licensed for use by others.

−	----	+	-----
−		+
	Online content should not be moved as this breaks links to them from other content. If it is necessary to move online content, redirects to the new location should be left behind.		Online content should not be moved as this breaks links to them from other content. If it is necessary to move online content, redirects to the new location should be left behind.

−	----	+	-----
−		+
	Provenance attributes:		Provenance attributes:
−	*Qualifications, status, suitable uses, reliability, disclaimer, current, refereed / certified / checked etc
−	*Tag quoted / used content for original provenance.
−	*Tag time-dependent info for checking.

−	-~~---~~	+	* Qualifications, status, suitable uses, reliability, disclaimer, current, refereed / certified / checked etc
		+	* Tag quoted / used content for original provenance.
		+	* Tag time-dependent info for checking.

		+	-----
	Version control makes collaboration easier.		Version control makes collaboration easier.

−	----	+	-----
−		+
	Provide templates		Provide templates

−	----	+	-----
−		+	Look at CrossMark system.
−	Look at CrossMark system ~~[http://www.crossref.org/crossmark/&nbsp http://www.crossref~~.~~org/crossmark/]~~	+

Designing Buildings at 15:47, 28 September 2015

2015-09-28T15:47:46Z

← Older revision		Revision as of 15:47, 28 September 2015
Line 1:		Line 1:

−	'''To add your thoughts to this discussion page, click '~~Edit this article~~' above.'''	+	'''To add your thoughts to this discussion page, click 'Add a comment' above.'''

	----		----

86.168.133.4 at 12:39, 18 April 2015

2015-04-18T12:39:10Z

← Older revision		Revision as of 12:39, 18 April 2015
Line 124:		Line 124:

	Provide templates		Provide templates
		+
		+	----
		+
		+	Look at CrossMark system [http://www.crossref.org/crossmark/&nbsp http://www.crossref.org/crossmark/]

86.168.133.4 at 14:02, 15 April 2015

2015-04-15T14:02:50Z

← Older revision		Revision as of 14:02, 15 April 2015
Line 120:		Line 120:

	Version control makes collaboration easier.		Version control makes collaboration easier.
		+
		+	----
		+
		+	Provide templates

86.168.133.4 at 14:00, 15 April 2015

2015-04-15T14:00:47Z

← Older revision		Revision as of 14:00, 15 April 2015
Line 116:		Line 116:
	*Tag quoted / used content for original provenance.		*Tag quoted / used content for original provenance.
	*Tag time-dependent info for checking.		*Tag time-dependent info for checking.
		+
		+	----
		+
		+	Version control makes collaboration easier.

Designing Buildings at 13:39, 6 April 2015

2015-04-06T13:39:19Z

← Older revision		Revision as of 13:39, 6 April 2015
Line 109:		Line 109:

	Online content should not be moved as this breaks links to them from other content. If it is necessary to move online content, redirects to the new location should be left behind.		Online content should not be moved as this breaks links to them from other content. If it is necessary to move online content, redirects to the new location should be left behind.
		+
		+	----
		+
		+	Provenance attributes:
		+	*Qualifications, status, suitable uses, reliability, disclaimer, current, refereed / certified / checked etc
		+	*Tag quoted / used content for original provenance.
		+	*Tag time-dependent info for checking.

Designing Buildings at 12:10, 24 March 2015

2015-03-24T12:10:40Z

← Older revision		Revision as of 12:10, 24 March 2015
Line 105:		Line 105:

	Some knowledge is proprietary, and whilst it could be produced following a standard, it would not be accessible or licensed for use by others.		Some knowledge is proprietary, and whilst it could be produced following a standard, it would not be accessible or licensed for use by others.
		+
		+	----
		+
		+	Online content should not be moved as this breaks links to them from other content. If it is necessary to move online content, redirects to the new location should be left behind.