add docs about query params in links