2016-08-08 12:42:20 +00:00
|
|
|
#!/usr/bin/env bash
|
|
|
|
|
|
|
|
cd "$(dirname "$0")/.."
|
|
|
|
|
|
|
|
# Use long options (e.g. --header instead of -H) for curl examples in documentation.
|
2018-03-26 13:05:33 +00:00
|
|
|
echo '=> Checking for cURL short options...'
|
2017-09-25 08:50:06 +00:00
|
|
|
grep --extended-regexp --recursive --color=auto 'curl (.+ )?-[^- ].*' doc/ >/dev/null 2>&1
|
2017-10-03 15:15:40 +00:00
|
|
|
if [ $? -eq 0 ]
|
2016-08-08 12:42:20 +00:00
|
|
|
then
|
2017-09-25 08:50:06 +00:00
|
|
|
echo '✖ ERROR: Short options for curl should not be used in documentation!
|
|
|
|
Use long options (e.g., --header instead of -H):' >&2
|
|
|
|
grep --extended-regexp --recursive --color=auto 'curl (.+ )?-[^- ].*' doc/
|
2016-08-08 12:42:20 +00:00
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
2016-10-16 18:29:45 +00:00
|
|
|
# Ensure that the CHANGELOG.md does not contain duplicate versions
|
|
|
|
DUPLICATE_CHANGELOG_VERSIONS=$(grep --extended-regexp '^## .+' CHANGELOG.md | sed -E 's| \(.+\)||' | sort -r | uniq -d)
|
2018-03-26 13:05:33 +00:00
|
|
|
echo '=> Checking for CHANGELOG.md duplicate entries...'
|
2016-08-25 20:48:17 +00:00
|
|
|
if [ "${DUPLICATE_CHANGELOG_VERSIONS}" != "" ]
|
|
|
|
then
|
2016-10-16 18:29:45 +00:00
|
|
|
echo '✖ ERROR: Duplicate versions in CHANGELOG.md:' >&2
|
2016-08-25 20:48:17 +00:00
|
|
|
echo "${DUPLICATE_CHANGELOG_VERSIONS}" >&2
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
2017-09-25 08:50:06 +00:00
|
|
|
# Make sure no files in doc/ are executable
|
2017-09-25 08:59:25 +00:00
|
|
|
EXEC_PERM_COUNT=$(find doc/ app/ -type f -perm 755 | wc -l)
|
2018-03-26 13:05:33 +00:00
|
|
|
echo '=> Checking for executable permissions...'
|
2017-09-25 08:50:06 +00:00
|
|
|
if [ "${EXEC_PERM_COUNT}" -ne 0 ]
|
|
|
|
then
|
|
|
|
echo '✖ ERROR: Executable permissions should not be used in documentation! Use `chmod 644` to the files in question:' >&2
|
2017-09-25 08:59:25 +00:00
|
|
|
find doc/ app/ -type f -perm 755
|
2017-09-25 08:50:06 +00:00
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
2018-03-26 13:05:33 +00:00
|
|
|
# Do not use 'README.md', instead use 'index.md'
|
|
|
|
# Number of 'README.md's as of 2018-03-26
|
2019-05-05 16:27:37 +00:00
|
|
|
NUMBER_READMES_CE=46
|
2018-03-26 13:05:33 +00:00
|
|
|
NUMBER_READMES_EE=46
|
|
|
|
FIND_READMES=$(find doc/ -name "README.md" | wc -l)
|
|
|
|
echo '=> Checking for new README.md files...'
|
|
|
|
if [ "${CI_PROJECT_NAME}" == 'gitlab-ce' ]
|
|
|
|
then
|
|
|
|
if [ ${FIND_READMES} -ne ${NUMBER_READMES_CE} ]
|
|
|
|
then
|
|
|
|
echo
|
|
|
|
echo ' ✖ ERROR: New README.md file(s) detected, prefer index.md over README.md.' >&2
|
|
|
|
echo ' https://docs.gitlab.com/ee/development/writing_documentation.html#location-and-naming-documents'
|
|
|
|
echo
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
elif [ "${CI_PROJECT_NAME}" == 'gitlab-ee' ]
|
|
|
|
then
|
|
|
|
if [ ${FIND_READMES} -ne $NUMBER_READMES_EE ]
|
|
|
|
then
|
|
|
|
echo
|
|
|
|
echo ' ✖ ERROR: New README.md file(s) detected, prefer index.md over README.md.' >&2
|
|
|
|
echo ' https://docs.gitlab.com/ee/development/writing_documentation.html#location-and-naming-documents'
|
|
|
|
echo
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
fi
|
|
|
|
|
2016-08-08 12:42:20 +00:00
|
|
|
echo "✔ Linting passed"
|
|
|
|
exit 0
|